MCP server for codebase Q&A powered by RAG — index any git repo and ask questions about the code
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":"codebase-qa-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.
# Codebase Q&A MCP Server An MCP server that lets AI assistants answer questions about any codebase using RAG (Retrieval-Augmented Generation). Index any git repository locally, then ask natural-language questions — answers are grounded in actual source code. Built with [FastMCP](https://github.com/jlowin/fastmcp), [ChromaDB](https://www.trychroma.com/), and [sentence-transformers](https://www.sbert.net/). ## How It Works ``` ┌─────────────┐ ┌──────────────────────────────────────────────┐ │ AI Client │ │ Codebase Q&A MCP Server │ │ (Claude Code,│ MCP │ │ │ Claude │◄───►│ ┌─────────┐ ┌──────────┐ ┌───────────┐ │ │ Desktop, │ │ │ Load & │─►│ Embed │─►│ ChromaDB │ │ │ Cursor) │ │ │ Chunk │ │(MiniLM) │ │ (persist) │ │ │ │ │ └─────────┘ └──────────┘ └───────────┘ │ └─────────────┘ └──────────────────────────────────────────────┘ ``` 1. **Index** — Point the server at a git repo. It reads all source files, splits them into chunks, generates embeddings with `all-MiniLM-L6-v2`, and stores them in a persistent ChromaDB instance. 2. **Query** — Ask a natural-language question. The server finds the most relevant code chunks via semantic similarity and returns them with file paths and metadata. 3. **Update** — After new commits, run an incremental update that only re-indexes changed files (using `git diff`). ## Features - **7 MCP tools** for full codebase Q&A workflow - **Local embeddings** — no API keys needed (runs `all-MiniLM-L6-v2` on your machine) - **Persistent storage** — ChromaDB persists indexes across sessions - **Incremental updates** — only re-index files that changed since last commit - **Multi-project support** — index multiple repos and switch between them - **File filtering** — narrow queries to specific paths (e.g. only `auth`-related files) - **30+ file types** supported (Python, JS/TS, Go, Rust, Java, C/C++,…
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.