repomap-mcp

<p align="center"> </p>

<p align="center"> <a href="https://www.npmjs.com/package/repomap-mcp"></a> <a href="https://github.com/fl0w1nd/repomap-mcp/blob/main/LICENSE"></a> <a href="https://nodejs.org"></a> </p>

> [中文文档](./README.zh-CN.md)

An MCP server and CLI tool that generates ranked, token-budgeted code structure maps using Tree-sitter AST analysis and PageRank. Designed for AI agents that need to quickly understand unfamiliar codebases.

Inspired by aider's repo map, reimplemented in TypeScript via RepoMapper.

AI coding agents face a fundamental problem: large codebases don't fit in a context window. Without structural awareness, agents resort to guessing file paths, reading irrelevant code, or asking the user to point them to the right place.

| | Without repomap-mcp | With repomap-mcp | |---|---|---| | Codebase understanding | Blindly cat files one by one | Get a ranked structural overview in one call | | Finding related code | Grep for strings, miss semantic connections | PageRank surfaces cross-file dependencies | | Token efficiency | Read entire files, blow context budget | Token-budgeted output, only the important parts | | Multi-language repos | Regex-based hacks per language | 40+ languages via Tree-sitter AST, zero config | | Task-specific focus | Same flat file listing every time | Personalized ranking based on focus files and identifiers |

• Semantic, not textual — uses Tree-sitter AST to extract real definitions and references, not string matching
• PageRank ranking — files that are heavily