Local-first code knowledge graph MCP server
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":"code-graph-rag-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.
# Code GraphRAG MCP Server A Model Context Protocol server for source-code introspection. It keeps a local-first knowledge graph for your repositories: Tree-sitter derived symbols and relations, AST-aligned chunks, EmbeddingGemma vectors stored in sqlite-vec, and graph traversal through bfsvtab. Wheels ship the native extensions, so the server starts instantly with `uvx`. ## Features - Hybrid retrieval combining vector search and breadth-first graph expansion over code relations - Live repository sync via filesystem watcher and job queue - Deterministic provenance for every symbol, relation, and chunk - Bundled sqlite-vec and bfsvtab binaries—no manual compilation required ## Installation ```bash uvx code-graph-rag-mcp serve --config /workspace/config.yaml ``` ### MCP manifest example ```json { "mcpServers": { "code-graph": { "command": "uvx", "args": ["code-graph-rag-mcp", "serve", "--config", "/workspace/config.yaml"], "env": { "CODE_GRAPH_RAG_WATCH_DIR": "/workspace/repo", "CODE_GRAPH_RAG_DB_PATH": "/workspace/data/code.sqlite" } } } } ``` This manifest block works for Claude Desktop (`claude_desktop_config.json`), Cursor (`~/.cursor/mcp.json`), or any other MCP host. ## Configuration ### Minimal `config.yaml` ```yaml watch: dir: "/workspace/repo" database: sqlite_path: "/workspace/data/code.sqlite" ``` ### Environment overrides | Variable | Description | | --- | --- | | `CODE_GRAPH_RAG_CONFIG` | Alternate path to the YAML config. | | `CODE_GRAPH_RAG_WATCH_DIR` | Override repository directory to watch. | | `CODE_GRAPH_RAG_WATCH_DEBOUNCE_MS` | Debounce delay (ms) for watcher events. | | `CODE_GRAPH_RAG_DB_PATH` | Override SQLite database location. | | `CODE_GRAPH_RAG_EXTENSIONS_DIR` | Directory containing custom sqlite-vec/bfsvtab binaries. | | `CODE_GRAPH_RAG_SQLITE_VEC` / `CODE_GRAPH_RAG_BFSVTAB` | Explicit extension paths. | | `CODE_GRAPH_RAG_RETRIEVAL_K` | Default semantic top-k. | | `CODE_G…
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.