Local codebase index with MCP retrieval tools
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"repo-index-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# repo-index-mcp Local codebase retrieval tool for coding agents. It indexes committed code from local git repos into a local SQLite database, then exposes ranked snippets through a CLI and MCP stdio server. ## Install From GitHub with `pipx`: ```bash pipx install git+https://github.com/Zhachory1/repo-index-mcp.git@v0.2.3 ``` With npm/npx, after installing [`uv`](https://docs.astral.sh/uv/getting-started/installation/): ```bash npx repo-index-mcp doctor ``` The npm package is a thin wrapper around the Python package. It does not bundle local SQLite index data. For development: ```bash python -m venv .venv source .venv/bin/activate pip install -e '.[dev]' ``` Check local readiness: ```bash repo-index doctor ``` ## First success path For a deterministic five-minute smoke test, see `docs/getting-started.md`. Index this repo or another local git repo: ```bash repo-index index /path/to/git/repo ``` Query it: ```bash repo-index query "where is request retry handled" -k 5 ``` Lookup a symbol: ```bash repo-index get-symbol RepoIndex --repo /path/to/git/repo ``` Discover and index every git repo under a root: ```bash repo-index index-root ~/code ``` Show indexed repos and freshness: ```bash repo-index status ``` ## MCP setup Run the MCP server over stdio: ```bash repo-index serve ``` Agent config example: ```json { "mcpServers": { "repo-index": { "type": "stdio", "command": "/Users/YOU/.local/bin/repo-index", "args": ["--db", "/Users/YOU/.repo-index-mcp/index.sqlite", "serve"], "env": {} } } } ``` npm/npx config example: ```json { "mcpServers": { "repo-index": { "type": "stdio", "command": "npx", "args": ["-y", "repo-index-mcp", "--db", "/Users/YOU/.repo-index-mcp/index.sqlite", "serve"], "env": {} } } } ``` Use `which repo-index` to find the absolute command path for your machine when using direct CLI installs. ## Freshness hooks Install hooks for one repo or a repo roo…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.