MCP server for efficient code search
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-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-RAG [](https://pypi.org/project/code-rag-mcp/) [](https://github.com/qduc/code-rag/actions) [](https://opensource.org/licenses/MIT) [](https://pypi.org/project/code-rag-mcp/) **Semantic code search for your entire codebase.** Ask questions in plain English, get relevant code snippets with source locations. Instead of grepping for function names, ask "authentication logic" and find all related auth code across your project. ## Table of Contents - [Quick Start](#quick-start) - [Claude's Opinion About Code-RAG](#claudes-opinion-about-code-rag-take-it-with-a-huge-grain-of-salt) - [Why Use Code-RAG?](#why-use-code-rag) - [Use with Claude Code (MCP Integration)](#use-with-claude-code-mcp-integration) - [Configuration](#configuration) - [How It Works](#how-it-works) - [API Usage](#api-usage) - [Supported Languages](#supported-languages) - [Requirements](#requirements) - [Troubleshooting](#troubleshooting) - [Development](#development) - [Contributing](#contributing) ## Quick Start ### 1. Install **Using [uv](https://github.com/astral-sh/uv) (recommended):** ```bash uvx --from code-rag-mcp code-rag-setup --install ``` *Note: This installs Code-RAG in an isolated `uv` tool environment and keeps your configuration across updates.* **Using pip:** ```bash python -m venv .venv source .venv/bin/activate pip install code-rag-mcp code-rag-setup ``` *The setup wizard refuses to install optional dependencies into non-isolated Python by default. Use `code-rag-setup --allow-global-python` only if you intentionally want that behavior.* **New to Python?** Use the one-command installer: ```bash curl -sSL https://raw.githubusercontent.com/qduc/code-rag/main/scripts/install.sh | bash ``` …
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.