Skip to main content
Glama
Sign In
squatch-harbor-mcp

squatch-harbor-mcp

by squatch-c-c
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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 server, so it works in Claude Desktop (Chat) and Claude Code.

Run it (zero install — uvx fetches + runs)

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

Requires uv (curl -LsSf https://astral.sh/uv/install.sh | sh).

Related MCP server: MCP Claude Context Server

Add to Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.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 system.

Available Tools

3 tools
harbor_ingestA

Index your local Claude session transcripts so you can search them. Incremental by default (only re-reads changed files); pass rebuild=true to start fresh. Defaults to ~/.claude/projects.

Inputs: sessions_dir, rebuild.

harbor_searchA

Search your indexed Claude history for past work ('when did I…', 'how did we solve…'). Returns the top matches with session, date, role, and a snippet. Run harbor_ingest first.

Inputs: query (required), k. Returns: result

harbor_statsA

How big the harbor index is (message count, file count, date range) — or that it's not built yet.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool serves a unique purpose: ingest indexes files, search queries the index, and stats reports index metadata. No functional overlap.

    Naming Consistency5/5

    All tools follow a consistent 'harbor_verb' pattern (harbor_ingest, harbor_search, harbor_stats), using snake_case and clear verbs.

    Tool Count5/5

    With 3 tools, the set is minimal but perfectly scoped for the domain: index creation, querying, and status checking. No unnecessary tools.

    Completeness4/5

    The tool surface covers the full lifecycle: ingest (create/update), search (read), and stats (monitor). A tool to delete or clear the index is not provided but can be achieved via rebuild flag, so minor gap.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • cursor-history-mcp

      S2thend
      A
      license
      A
      quality
      B
      maintenance
      MCP server for browsing, searching, exporting, and backing up your Cursor AI chat history directly into Claude via natural language.
      8
      81 npm
      33
      MIT

    • MCP Claude Context Server

      hamzaamjad
      A
      license
      Not graded
      quality
      D
      maintenance
      A powerful MCP server that extracts, stores, searches, and analyzes Claude.ai conversations with SQLite database, semantic search, and multiple export formats including Obsidian and PDF.
      101 PyPI
      1
      MIT

    • RepoChatMCP

      gzmagyari
      A
      license
      A
      quality
      D
      maintenance
      A zero-dependency MCP server that enables searching and reading local Claude Code and Codex chat sessions, supporting full-text search, grep, and knowledge indexing from chat history.
      15
      16 npm
      MIT