MCP SERVERHand a model a ranked outline of a repository — function prototypes and variables for the files in play, plus the related files it should have asked about — built to a token budget you set.
LABSCO SUMMARY
Both tools answer the same underlying question — what else should I be looking at — from opposite ends: repo_map ranks neighbouring files around the ones you name, and search_identifiers finds a name with its line and context, split into definitions and references. token_limit and max_context_window are the arguments that matter, because the map is built to a budget instead of being truncated after the fact. Two tools is the entire surface, which places this underneath a coding assistant rather than in place of one.
A repository-mapping server that builds a ranked outline of a codebase around a set of files, with an identifier search across the same tree.
Python 3 with the packages in requirements.txt, and the repository on local disk: both tools take a project_root and expect the filenames you pass to be relative to it.
Build from source — git clone https://github.com/pdavis68/RepoMapper
USE CASES
Name the files you already know are in play and let the map rank the rest around them, bounded by a token limit so the outline fits the window it is about to be read in.
Search the tree for the name with surrounding context, and split definitions from references when you need to know where it comes from rather than where it is called.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
repo_mapGenerate a repository map for the specified files, providing a list of function prototypes and variables for files as well as relevant related files. Provide filenames relative to the project_root. In addition to the files provided, relevant related files will also be included with a very small ranking boost.
search_identifiersSearch for identifiers in code files. Get back a list of matching identifiers with their file, line number, and context. When searching, just use the identifier name without any special characters, prefixes or suffixes. The search is case-insensitive.
BEFORE YOU INSTALL
2 tools when we connected.
Python 3 and pip
Both documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
git clone https://github.com/pdavis68/RepoMapper
cd RepoMapper
pip install -r requirements.txt
python repomap_server.py{
"mcpServers": {
"RepoMapper": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "/usr/bin/python3",
"args": [
"<YOUR_PATH_TO_REPOMAP_SERVER>"
]
}
}
}MCP servers
mleoca
James-Chahwan
admica
adhikasp