MCP server for ctags-based code navigation in Claude 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":"ctags-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.
# MCP Ctags Server [](https://www.python.org/downloads/) [](LICENSE) A Model Context Protocol (MCP) server that transforms ctags from a command-line utility into a native code navigation system for Claude Code. Built with a functional programming approach and comprehensive type safety. ## Quick Start ```bash # Install the package pip install ctags-mcp # Generate tags for your project ctags -R . # Add to Claude Desktop config { "mcpServers": { "ctags": { "command": "ctags-mcp" } } } # Optional: Auto-regenerate tags when code changes # Copy .claude/settings.json to your project root ``` **[📖 Full Installation Guide](INSTALL.md)** | **[🔄 Auto-Regeneration Setup](AUTO_REGENERATION.md)** ## ✨ Features - **🚀 20x Performance**: Index-based symbol lookup vs reading entire files - **🔍 Smart Search**: Regex patterns, type filtering, scope-aware queries - **📁 Universal Support**: Works with any ctags-supported language - **🎯 Precise Context**: Get source code around symbols with configurable line counts - **🔧 Auto-Detection**: Finds tags files in current and parent directories - **⚡ Zero Configuration**: Works out of the box with standard ctags files ## 🎯 What It Does Transform code exploration from this: ```bash # Traditional approach - slow, imprecise find . -name "*.py" | xargs grep "async def" grep -r "class.*Service" src/ ``` To this: ```text # Natural language with Claude "Find all async functions in this project" "Show me service classes with their locations" "Get the AsyncBatchProcessor definition with context" ``` ## 📊 Performance Comparison | Task | Traditional | MCP Ctags | Improvement | |------|-------------|-----------|-------------| | Find symbols | ~530ms | ~7ms | **79x faster** | | Files read | 53+ files | 0 files | **∞x better** | | Query accuracy | Manual parsing | Structured data | **M…
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.