{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_g3drfx2rbvts","handle":"codebase-qa-mcp","url":"https://wellknown.network/agents/codebase-qa-mcp","links":{"self":"https://wellknown.network/agents/codebase-qa-mcp/record.json","html":"https://wellknown.network/agents/codebase-qa-mcp","markdown":"https://wellknown.network/agents/codebase-qa-mcp/record.md","api":"https://wellknown.network/api/v1/agents/codebase-qa-mcp","status":"https://wellknown.network/api/v1/agents/codebase-qa-mcp/status","claim":"https://wellknown.network/agents/codebase-qa-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codebase-qa-mcp/claim.json","badge":"https://wellknown.network/agents/codebase-qa-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/codebase-qa-mcp/history","tools":"https://wellknown.network/api/v1/agents/codebase-qa-mcp/tools"},"ard":{"identifier":"urn:air::server:codebase-qa-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codebase-qa-mcp","summary":"MCP server for codebase Q&A powered by RAG — index any git repo and ask questions about the code","description":"# Codebase Q&A MCP Server\n\nAn 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.\n\nBuilt with [FastMCP](https://github.com/jlowin/fastmcp), [ChromaDB](https://www.trychroma.com/), and [sentence-transformers](https://www.sbert.net/).\n\n## How It Works\n\n```\n┌─────────────┐     ┌──────────────────────────────────────────────┐\n│  AI Client   │     │         Codebase Q&A MCP Server              │\n│ (Claude Code,│ MCP │                                              │\n│  Claude      │◄───►│  ┌─────────┐  ┌──────────┐  ┌───────────┐  │\n│  Desktop,    │     │  │  Load &  │─►│ Embed    │─►│ ChromaDB  │  │\n│  Cursor)     │     │  │  Chunk   │  │(MiniLM)  │  │ (persist) │  │\n│              │     │  └─────────┘  └──────────┘  └───────────┘  │\n└─────────────┘     └──────────────────────────────────────────────┘\n```\n\n1. **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.\n2. **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.\n3. **Update** — After new commits, run an incremental update that only re-indexes changed files (using `git diff`).\n\n## Features\n\n- **7 MCP tools** for full codebase Q&A workflow\n- **Local embeddings** — no API keys needed (runs `all-MiniLM-L6-v2` on your machine)\n- **Persistent storage** — ChromaDB persists indexes across sessions\n- **Incremental updates** — only re-index files that changed since last commit\n- **Multi-project support** — index multiple repos and switch between them\n- **File filtering** — narrow queries to specific paths (e.g. only `auth`-related files)\n- **30+ file types** supported (Python, JS/TS, Go, Rust, Java, C/C++,…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:codebase-qa-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.791,"provenance":"derived"},{"slug":"code.testing","name":"Testing","confidence":0.625,"provenance":"derived"}],"categories":["code","data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codebase-qa-mcp","registry":"pypi","observedAt":"2026-09-15T11:23:10.456Z","publishedAt":"2026-02-28T18:31:48.842815Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codebase-qa-mcp","url":"https://pypi.org/project/codebase-qa-mcp/","firstSeenAt":"2026-09-09T11:31:29.586Z","fetchedAt":"2026-09-15T11:22:32.670Z","normalizedAt":"2026-09-15T11:22:32.670Z"}]},"firstSeenAt":"2026-09-09T11:31:29.586Z","updatedAt":"2026-09-15T11:23:10.456Z"}