simple-memory-mcp

Personal memory MCP server backed by SQLite FTS5 BM25 search with temporal reranking.

Setup

bun install

Run

bun run start

The server uses stdio transport and creates memory.db in the project root.

Run From GitHub With bunx

bunx --bun github:mrorigo/simple-memory-mcp#main

Because of the bin entry, this starts the simple-memory-mcp CLI directly.

For MCP client configuration (example):

{
  "mcpServers": {
    "simple_memory": {
      "command": "bunx",
      "args": ["--bun", "github:mrorigo/simple=memory-mcp#main"]
    }
  }
}

Tools

• ingest_document
  • Inputs: filename (string), content (string), attribution (optional string)
• search_memory
  • Inputs: query (string), limit (optional number, default 5, max 50)
  • Ranking: |bm25| * (1 / (1 + 0.05 * ageInDays))

Verify

bun test
bun run typecheck
bun run smoke