# squatch-harbor-mcp

Search your **own past Claude sessions**, locally. Indexes `~/.claude/projects/*.jsonl` into a
local **SQLite FTS5** file and searches it — *"when did I set up auth?"*, *"how did we solve X?"*.
**No cloud, nothing leaves your machine.** Stdlib only (no numpy). An [MCP](https://modelcontextprotocol.io)
server, so it works in Claude Desktop (Chat) and Claude Code.

## Run it (zero install — `uvx` fetches + runs)

```bash
uvx --from git+https://github.com/squatch-c-c/squatch-harbor-mcp squatch-harbor-mcp
```

Requires [`uv`](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`).

## Add to Claude Desktop

`~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "harbor": { "command": "uvx", "args": ["--from", "git+https://github.com/squatch-c-c/squatch-harbor-mcp", "squatch-harbor-mcp"] }
  }
}
```

Restart Claude, then: *"ingest my harbor, then search it for when I set up the egress guard."*

## Tools
| Tool | What it does |
|---|---|
| `harbor_ingest(sessions_dir?, rebuild?)` | Index your sessions (incremental; run first). |
| `harbor_search(query, k=8)` | Top matches — session, date, role, snippet. |
| `harbor_stats()` | Index size + date range. |

Local-only. Index lives at `~/.harbor/harbor-mcp.db`. Part of the [Squatch](https://squatch.cc) system.