RepoMapperSAFE
A tool to produce a map of a codebase within a git repository. Based entirely on the "Repo Map" functionality in Aider.chat
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
RepoMap is a powerful tool designed to help, primarily LLMs, understand and navigate complex codebases. It functions both as a command-line application for on-demand analysis and as an MCP (Model Context Protocol) server, providing continuous repository mapping capabilities to other applications. By generating a "map" of the software repository, RepoMap highlights important files, code definitions, and their relationships. It leverages Tree-sitter for accurate code parsing and the PageRank algorithm to rank code elements by importance, ensuring that the most relevant information is always prioritized.
Table of Contents
- Aider
- Example Output
- Features
- Installation
- Usage
- Basic Usage
- Advanced Options
- How It Works
- Output Format
- Dependencies
- Caching
- Supported Languages
- License
- Running as an MCP Server
- Setup
- Usage
- Changelog
Aider
RepoMap is 100% based on Aider's Repo map functionality, but I don't believe it shares any code with it. Allow me to explain.
My original effort was to take the RepoMap class from Aider, remove all the aider-specific dependencies, and then make it into a command-line tool. Python isn't my native language and I really struggled to get it to work.
So a few hours ago, I had a different idea. I took the RepoMap and some of its related code from aider and I fed it to an LLM (Either Claude or Gemini 2.5 Pro, can't remember) and had it create specifications for this, basically, from aider's imple
60b2aed8fadbOBSERVED · 2026-10-06Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add repomapper -- uvx repomapper
{
"mcpServers": {
"repomapper": {
"command": "uvx",
"args": [
"repomapper"
]
}
}
}Exposed tools (2)
2 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
repo_map | read | Generate a repository map for the specified files, providing a list of function prototypes and variables for files as well as relevant related |
search_identifiers | read | Search for identifiers in code files. Get back a list of matching identifiers with their file, line number, and context. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (1)
tiktoken, networkx, diskcache, grep-ast, tree-sitter, pygments, fastmcp
Gates applied: no_behavioural_pass.
60b2aed8fadbfull audit observations/trust-audit/mcp-server/pdavis68__repomapper.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-06 | 60b2aed8fadb | SAFE | B | 89 | first audit |
Questions
What is the RepoMapper MCP server?
A tool to produce a map of a codebase within a git repository. Based entirely on the "Repo Map" functionality in Aider.chat
What tools does RepoMapper expose?
2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is RepoMapper safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does RepoMapper need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (60b2aed8fadb), read on 2026-10-06. The repository is watched and re-audited when it changes.