Skip to main content
Glama
deenesjakoruzh
Kevin-CNC

repo-map-mcp

by Kevin-CNC
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

repo-map-mcp

MCP server that maintains a self-updating, per-file JSON index of a repo (directory, filename, description, function names, timestamps) so an agent can query "what's probably relevant" instead of grepping/reading the whole tree.

File exploration and path annotation computed locally; Description and file purpose are dictated by the agent, which provides them even better context.

Install

uv sync

Related MCP server: mcp-code-indexer

Tools

  • index_repository(root_path, force=False) — walk root_path (respecting .gitignore + hardcoded excludes), hash each file, re-parse function names for changed files, update the on-disk index at <root_path>/.repo-index/index.json. Returns a summary string.

  • get_repo_map(root_path, dir_prefix=None) — return the JSON index, optionally scoped to a subdirectory.

  • search_files(root_path, query) — substring match against filename, description, and function names.

  • get_stale_files(root_path) — files whose descriptionStale flag is set, with their function names, so the calling agent can write a description without opening the file.

  • set_description(root_path, path, description) — writes the description back and clears the stale flag.

Supported languages for function extraction (via tree-sitter): Python, JavaScript, TypeScript, TSX, Java, Rust. Other file types still get indexed, with funcs: [].

Requirements:

  • Python

  • uv

Run

uv run repo-map-mcp

Runs on stdio — add it to an MCP client config (e.g. Claude Code) pointing command at uv run repo-map-mcp (cwd set to this directory, or use an absolute path).

Test

uv run pytest -q
uv run python3 scripts/smoke_client.py   # end-to-end tool call smoke test
Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Headless Codebase Indexer

    y1hanh
    F
    license
    Not graded
    quality
    D
    maintenance
    A minimalist indexing tool that provides AI agents with semantic search and structural AST parsing for deep codebase understanding. It enables autonomous agents to navigate large codebases predictably using vector embeddings and native language server capabilities like definition and reference tracking.

  • mcp-code-indexer

    fluffypony
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to intelligently navigate and understand codebases by providing instant file descriptions, semantic search, and context-aware recommendations, eliminating the need to repeatedly scan files.
    18
    MIT

View all related MCP servers

Related MCP Connectors

  • Umtri

    Give your AI agent a persistent map of your project's structure, dependencies, and bugs.

  • AXIS Toolbox — Agentic Commerce Codebase Intelligence

    Generate AGENTS.md, AP2 compliance docs, checkout rules, debug playbook & MCP configs from any repo.

  • Orcha

    Securely search and manage workspace context files for AI agents and teams.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kevin-CNC/better-scout'

If you have feedback or need assistance with the MCP directory API, please join our Discord server