repomap-mcp

Local stdio Model Context Protocol (MCP) server for Aider's AST Tree-sitter and PageRank repository mapping.

Deterministic, offline, zero API keys. Generates concise code skeletons to orient LLMs within token budgets.

Setup

Add to your MCP client config (Claude Desktop, Cursor, Cline):

{
  "mcpServers": {
    "repomap": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/repomap-mcp", "repomap-mcp"]
    }
  }
}

Or run directly from GitHub without cloning:

{
  "mcpServers": {
    "repomap": {
      "command": "uv",
      "args": [
        "run",
        "--from",
        "git+https://github.com/mi7chal/repomap-mcp",
        "repomap-mcp"
      ]
    }
  }
}

Related MCP server: codebase-rag

Tools

get_repo_map

Returns a PageRank-ranked code skeleton fitting within max_map_tokens, prefixed with coverage telemetry.

• root_path (string, default: "."): Target directory (scopes candidate files; "." maps entire repo).

• include_tests (bool, default: false): Include unit tests and tests/ directories.

• types_only (bool, default: false): Filter to type definitions (structs, classes, interfaces, enums).

• focus_files (list[string]): Currently active/edited files to bias PageRank towards.

• other_files (list[string]): Explicit file list. Defaults to scoped discovered files.

• mentioned_idents (list[string]): Symbol names to prioritize.

• max_map_tokens (int, default: 2048): Max token budget.

• force_refresh (bool, default: false): Invalidate tag cache.

get_tags

Extracts Tree-sitter definitions and references for a specific file.

• file_path (string): Target source file.

• root_path (string, default: "."): Repository or target directory.

Cache

• Git repos: .git/repomap-mcp/cache (natively ignored by git, zero root pollution).

• Non-git / read-only: ~/.cache/repomap-mcp/tags-<hash>.

• Override: REPOMAP_CACHE_DIR environment variable.

Development

uv run pytest
uv run prek run --all-files

AI Transparency

This project was developed with AI assistance.

License

Apache License 2.0. Derived from Aider by Paul Gauthier. See LICENSE and NOTICE.