Skip to main content
Glama

repo-map-mcp

MCP 服务器,用于维护一个自更新的、逐文件的仓库 JSON 索引(目录、文件名、说明、函数名、时间戳),这样智能体就可以查询“哪些内容可能相关”,而不用 grep 或遍历整个仓库。

文件探索和路径标注在本地完成;描述和文件用途由智能体来提供,这样能获得更好的上下文。

安装

uv sync

Related MCP server: mcp-code-indexer

工具

  • index_repository(root_path, force=False) — 遍历 root_path(尊重 .gitignore 和硬编码排除项),对每个文件计算哈希,为变更过的文件重新解析函数名,并更新 <root_path>/.repo-index/index.json 处的磁盘索引。返回一个摘要字符串。

  • get_repo_map(root_path, dir_prefix=None) — 返回 JSON 索引,可选择限定到某个子目录。

  • search_files(root_path, query) — 对文件名、描述和函数名进行子串匹配。

  • get_stale_files(root_path) — 返回设置了 descriptionStale 标志的文件及其函数名,以便调用方智能体在无需打开文件的情况下编写描述。

  • set_description(root_path, path, description) — 将描述写回索引并移除该文件的 stale 标志。

支持函数提取的语言:Python、JavaScript、TypeScript、TSX、Java、Rust。其他文件类型也会被建立索引,其中函数为 funcs: []

要求:

  • Python

  • uv

运行

uv run repo-map-mcp

在 stdio 上运行 — 把它添加到 MCP 客户端配置(例如 Claude Code)中,将 command 指向 uv run repo-map-mcp(cwd 设为当前目录,或者使用绝对路径)。

测试

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

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.

Related MCP Servers

  • 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.
  • 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

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

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

  • 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