# simple-memory-mcp

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

## Setup

```bash
bun install
```

## Run

```bash
bun run start
```

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

## Run From GitHub With `bunx`

```bash
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):

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

## Tools

- `ingest_document`
  - Inputs: `filename` (string path to a UTF-8 text file)
- `search_memory`
  - Inputs: `query` (string), `limit` (optional number, default `5`, max `50`)
  - Ranking: `|bm25| * (1 / (1 + 0.05 * ageInDays))`
- `scrub_document`
  - Inputs: `filename` (string path/identifier as stored in memory)
  - Behavior: removes all matching records from the memory database only; does not delete or modify files on disk.

## Verify

```bash
bun test
bun run typecheck
bun run smoke
```