{"id":45260404,"url":"https://github.com/SimplyLiz/CodeMCP","last_synced_at":"2026-03-05T23:01:10.526Z","repository":{"id":329194722,"uuid":"1117667087","full_name":"SimplyLiz/CodeMCP","owner":"SimplyLiz","description":"Code intelligence for AI assistants - MCP server, CLI, and HTTP API with symbol navigation, impact analysis, and architecture mapping","archived":false,"fork":false,"pushed_at":"2026-02-01T10:05:32.000Z","size":102870,"stargazers_count":48,"open_issues_count":2,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-01T20:25:14.572Z","etag":null,"topics":["ai","architecture","claude","cli","code-analysis","code-intelligence","cursor","developer-tools","golang","llm","lsp","mcp","mcp-server","refactoring","scip"],"latest_commit_sha":null,"homepage":"https://github.com/SimplyLiz/CodeMCP/wiki","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SimplyLiz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"SimplyLiz"}},"created_at":"2025-12-16T16:32:09.000Z","updated_at":"2026-02-01T10:05:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SimplyLiz/CodeMCP","commit_stats":null,"previous_names":["simplyliz/codemcp"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/SimplyLiz/CodeMCP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyLiz%2FCodeMCP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyLiz%2FCodeMCP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyLiz%2FCodeMCP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyLiz%2FCodeMCP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimplyLiz","download_url":"https://codeload.github.com/SimplyLiz/CodeMCP/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimplyLiz%2FCodeMCP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30154265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T22:39:40.138Z","status":"ssl_error","status_checked_at":"2026-03-05T22:39:24.771Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","architecture","claude","cli","code-analysis","code-intelligence","cursor","developer-tools","golang","llm","lsp","mcp","mcp-server","refactoring","scip"],"created_at":"2026-02-21T00:00:41.391Z","updated_at":"2026-03-05T23:01:10.520Z","avatar_url":"https://github.com/SimplyLiz.png","language":"Go","readme":"# CKB — Code Knowledge Backend\n\n**Know your code. Change it safely. Ship with confidence.**\n\n[![npm version](https://img.shields.io/npm/v/@tastehub/ckb.svg)](https://www.npmjs.com/package/@tastehub/ckb)\n[![Website](https://img.shields.io/badge/website-codeknowledge.dev-teal.svg)](https://codeknowledge.dev)\n[![Documentation](https://img.shields.io/badge/docs-codeknowledge.dev-blue.svg)](https://codeknowledge.dev/docs)\n\nCKB transforms your codebase into a queryable knowledge base. Ask questions, understand impact, find owners, detect dead code—all through CLI, API, or AI assistants.\n\n\u003e Think of it as a senior engineer who knows every line of code, every decision, and every owner—available 24/7 to answer your questions.\n\n---\n\n## Instant Answers to Hard Questions\n\n| Question | Without CKB | With CKB |\n|----------|-------------|----------|\n| \"What breaks if I change this?\" | Grep and hope | Precise blast radius with risk score |\n| \"Who should review this PR?\" | Guess from git blame | Data-driven reviewer suggestions |\n| \"Is this code still used?\" | Delete and see what breaks | Confidence-scored dead code detection |\n| \"What tests should I run?\" | Run everything (30 min) | Run affected tests only (2 min) |\n| \"How does this system work?\" | Read code for hours | Query architecture instantly |\n| \"Who owns this code?\" | Search CODEOWNERS manually | Ownership with drift detection |\n| \"Are there exposed secrets?\" | Manual grep for patterns | Automated scanning with 26 patterns |\n\n---\n\n## What You Can Do\n\n🔍 **Understand** — Semantic search, call graphs, usage tracing, architecture maps\n\n⚡ **Analyze** — Impact analysis, risk scoring, hotspot detection, coupling analysis\n\n🛡️ **Protect** — Affected test detection, breaking change warnings, PR risk assessment\n\n🔐 **Secure** — Secret detection, credential scanning, security-sensitive code identification\n\n👥 **Collaborate** — Ownership lookup, reviewer suggestions, architectural decisions (ADRs)\n\n📊 **Improve** — Dead code detection, tech debt tracking, documentation coverage\n\n🚀 **Compound Operations** — Single-call tools (`explore`, `understand`, `prepareChange`) reduce AI tool calls by 60-70%\n\n🔗 **Integrate** — CLI, HTTP API, MCP for AI tools, CI/CD pipelines, custom scripts\n\n---\n\n## Try It Now\n\n```bash\n# See what's risky in your codebase\nckb hotspots --format=human\n\n# Check what changed and what might break\nckb diff-summary --format=human\n\n# Scan for exposed secrets\nckb audit --format=human\n\n# Check architecture at a glance\nckb arch --format=human\n\n# Check system status\nckb status\n```\n\n---\n\n## Works Everywhere\n\n| AI Assistants | CI/CD | Your Tools |\n|---------------|-------|------------|\n| Claude Code, Cursor, Windsurf, VS Code, Grok | GitHub Actions, GitLab CI | CLI, HTTP API, Scripts |\n\n**83% token reduction** with smart presets—load only the tools you need.\n\n```bash\n# One command to connect to Claude Code\nckb setup\n```\n\n\u003e **Building your own tools?** Use CKB as a backend via CLI, HTTP API, or MCP. See the **[Integration Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Integration-Guide)** for examples in Node.js, Python, Go, and shell scripts.\n\n---\n\n## Learn More\n\n| Resource | Description |\n|----------|-------------|\n| 📖 **[Features Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Features)** | Complete feature list with examples |\n| 💬 **[Prompt Cookbook](https://github.com/SimplyLiz/CodeMCP/wiki/Prompt-Cookbook)** | Real prompts for real problems |\n| 🔌 **[Integration Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Integration-Guide)** | Use CKB in your own tools and scripts |\n| ⚡ **[Impact Analysis](https://github.com/SimplyLiz/CodeMCP/wiki/Impact-Analysis)** | Blast radius, affected tests, PR risk |\n| 🔧 **[CI/CD Integration](https://github.com/SimplyLiz/CodeMCP/wiki/CI-CD-Integration)** | GitHub Actions, GitLab CI templates |\n\n---\n\n## Quick Start\n\n### Option 1: npm (Recommended)\n\n```bash\n# Install globally\nnpm install -g @tastehub/ckb\n\n# Or run directly with npx (no install needed)\nnpx @tastehub/ckb init\n```\n\n### Option 2: Homebrew (macOS/Linux)\n\n```bash\nbrew tap SimplyLiz/ckb\nbrew install ckb\n```\n\n### Option 3: Build from Source\n\n```bash\ngit clone https://github.com/SimplyLiz/CodeMCP.git\ncd CodeMCP\ngo build -o ckb ./cmd/ckb\n```\n\n### Setup\n\n```bash\n# 1. Initialize in your project\ncd /path/to/your/project\nckb init   # or: npx @tastehub/ckb init\n\n# 2. Generate SCIP index (optional but recommended)\nckb index  # auto-detects language and runs appropriate indexer\n\n# 3. Connect to Claude Code\nckb setup  # creates .mcp.json automatically\n\n# Or manually:\nclaude mcp add --transport stdio ckb -- npx @tastehub/ckb mcp\n```\n\n**Token efficiency shown at startup:**\n```\nCKB MCP Server v8.0.0\n  Active tools: 14 / 76 (18%)\n  Estimated context: ~1k tokens\n  Preset: core\n```\n\nNow Claude can answer questions like:\n- *\"What calls the HandleRequest function?\"*\n- *\"How is ProcessPayment reached from the API?\"*\n- *\"What's the blast radius if I change UserService?\"*\n- *\"Who owns the internal/api module?\"*\n- *\"Is this legacy code still used?\"*\n\n## Why CKB?\n\n| Without CKB | With CKB |\n|-------------|----------|\n| AI greps for patterns | AI navigates semantically |\n| \"I found 47 matches for Handler\" | \"HandleRequest is called by 3 routes via CheckoutService\" |\n| Guessing at impact | Knowing the blast radius with risk scores |\n| Reading entire files for context | Getting exactly what's relevant |\n| \"Who owns this?\" → search CODEOWNERS | Instant ownership with reviewer suggestions |\n| \"Is this safe to change?\" → hope | Hotspot trends + impact analysis |\n\n## Three Ways to Use It\n\n| Interface | Best For |\n|-----------|----------|\n| **[MCP](https://github.com/SimplyLiz/CodeMCP/wiki/MCP-Integration)** | AI-assisted development — Claude, Cursor, Windsurf, VS Code, OpenCode, Grok |\n| **[CLI](https://github.com/SimplyLiz/CodeMCP/wiki/User-Guide)** | Quick lookups from terminal, scripting |\n| **[HTTP API](https://github.com/SimplyLiz/CodeMCP/wiki/API-Reference)** | IDE plugins, CI integration, custom tooling |\n\n## How Indexing Works\n\nCKB uses **SCIP indexes** to understand your code. Think of it like a database that knows where every function is defined, who calls it, and how everything connects.\n\n### The Basics\n\n```bash\n# 1. Generate an index (auto-detects language)\nckb index\n\n# 2. Check if your index is fresh\nckb status\n```\n\nWithout an index, CKB still works using tree-sitter parsing (basic mode), but with an index you get:\n- Cross-file references (\"who calls this function?\")\n- Precise impact analysis\n- Call graph navigation\n\n### Language Support\n\nNot all languages are equal. CKB classifies languages into **quality tiers** based on indexer maturity:\n\n| Tier | Quality | Languages |\n|------|---------|-----------|\n| **Tier 1** | Full support, all features | Go |\n| **Tier 2** | Full support, minor edge cases | TypeScript, JavaScript, Python |\n| **Tier 3** | Basic support, call graph may be incomplete | Rust, Java, Kotlin, C++, Ruby, Dart |\n| **Tier 4** | Experimental | C#, PHP |\n\n**Key limitations:**\n- **Incremental indexing** is Go-only. Other languages require full reindex.\n- **TypeScript monorepos** may need `--infer-tsconfig` flag\n- **C/C++** requires `compile_commands.json`\n- **Python** works best with activated virtual environment\n\nRun `ckb doctor --tier standard` to check if your language tools are properly installed.\n\nSee **[Language Support](https://github.com/SimplyLiz/CodeMCP/wiki/Language-Support)** for indexer installation, known issues, and the full feature matrix.\n\n### Keeping Your Index Fresh\n\nYour index becomes stale when you make commits. CKB offers several ways to stay current:\n\n| Method | Command | When to Use |\n|--------|---------|-------------|\n| Manual | `ckb index` | One-off updates, scripts |\n| Watch mode | `ckb index --watch` | Auto-refresh during development |\n| MCP watch | `ckb mcp --watch` | Auto-refresh in AI sessions |\n| CI webhook | `POST /api/v1/refresh` | Trigger from CI/CD |\n\n**Quick start for AI sessions:**\n```bash\nckb mcp --watch  # Auto-reindexes every 30s when stale\n```\n\n**Check staleness:**\n```bash\nckb status\n# Shows: \"5 commits behind HEAD\" or \"Up to date\"\n```\n\nFor Go projects, CKB uses **incremental indexing**—only changed files are processed, making updates fast.\n\nSee the **[Index Management Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Index-Management)** for complete documentation.\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| [**Compound Operations**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#compound-operations) | `explore`, `understand`, `prepareChange` — single-call tools that reduce AI overhead by 60-70% |\n| [**Code Navigation**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#code-navigation--discovery) | Semantic search, call graphs, trace usage, find entrypoints |\n| [**Impact Analysis**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#impact-analysis--safety) | Blast radius, risk scoring, affected tests, breaking changes (`compareAPI`) |\n| [**Architecture**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#architectural-understanding) | Module overview, ADRs, dependency graphs, explain origin |\n| [**Ownership**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#ownership--review) | CODEOWNERS + git blame, reviewer suggestions, drift detection |\n| [**Code Quality**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#code-quality--risk) | Dead code detection (`findDeadCode`), coupling analysis, complexity |\n| [**Security**](https://github.com/SimplyLiz/CodeMCP/wiki/Security) | Secret detection, credential scanning, allowlists |\n| [**Documentation**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#documentation-intelligence) | Doc-symbol linking, staleness detection, coverage metrics |\n| [**Multi-Repo**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#multi-repo--federation) | Federation, API contracts, remote index serving |\n| [**Runtime**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#runtime-intelligence) | OpenTelemetry integration, observed usage, production dead code |\n| [**Streaming**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#streaming) | SSE streaming for `findReferences`, `searchSymbols` with real-time progress |\n| [**Automation**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#automation--cicd) | Daemon mode, watch mode, webhooks, incremental indexing |\n\n📖 **[Full Features Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Features)** — Detailed documentation with examples\n\n📋 **[Changelog](https://github.com/SimplyLiz/CodeMCP/blob/main/CHANGELOG.md)** — Version history\n\n## CLI\n\n```bash\nckb status           # System health (with remediation suggestions)\nckb search Handler   # Find symbols\nckb diff-summary     # Analyze what changed\nckb hotspots         # Risky areas\nckb arch             # Architecture overview\nckb ownership        # File/path ownership\nckb mcp              # Start MCP server\n```\n\n**v8.0 Compound Operations (via MCP):**\n```bash\n# These tools combine multiple queries into single calls\nexplore      # Area exploration: symbols, dependencies, hotspots\nunderstand   # Symbol deep-dive: refs, callers, explanation\nprepareChange # Pre-change analysis: impact, tests, risk\nbatchGet     # Fetch up to 50 symbols at once\nbatchSearch  # Run up to 10 searches at once\n```\n\n📖 **[User Guide](https://github.com/SimplyLiz/CodeMCP/wiki/User-Guide)** — All CLI commands and options\n\n## HTTP API\n\n```bash\n# Start the HTTP server\nckb serve --port 8080\n\n# Example calls\ncurl http://localhost:8080/health\ncurl http://localhost:8080/status\ncurl \"http://localhost:8080/search?q=NewServer\"\ncurl http://localhost:8080/architecture\ncurl \"http://localhost:8080/ownership?path=internal/api\"\ncurl http://localhost:8080/hotspots\n\n# Index Server Mode (v7.3) - serve indexes to remote clients\nckb serve --port 8080 --index-server --index-config config.toml\n\n# Index server endpoints\ncurl http://localhost:8080/index/repos\ncurl http://localhost:8080/index/repos/company%2Fcore-lib/meta\ncurl \"http://localhost:8080/index/repos/company%2Fcore-lib/symbols?limit=100\"\ncurl \"http://localhost:8080/index/repos/company%2Fcore-lib/search/symbols?q=Handler\"\n\n# Upload endpoints (with compression + auth)\ncurl -X POST http://localhost:8080/index/repos \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer ckb_xxx\" \\\n  -d '{\"id\":\"my-org/my-repo\",\"name\":\"My Repo\"}'\n\ngzip -c index.scip | curl -X POST http://localhost:8080/index/repos/my-org%2Fmy-repo/upload \\\n  -H \"Content-Encoding: gzip\" \\\n  -H \"Authorization: Bearer ckb_xxx\" \\\n  --data-binary @-\n\n# Token management (index server admin)\nckb token create --name \"ci-upload\" --scope upload    # Create API key\nckb token list                                         # List all tokens\nckb token revoke ckb_xxx                              # Revoke a token\nckb token rotate ckb_xxx                              # Rotate (new secret, same ID)\n```\n\n## MCP Integration\n\nCKB works with any MCP-compatible AI coding tool.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Code\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Auto-configure for current project\nnpx @tastehub/ckb setup\n\n# Or add globally for all projects\nnpx @tastehub/ckb setup --global\n```\n\nOr manually add to `.mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"command\": \"npx\",\n      \"args\": [\"@tastehub/ckb\", \"mcp\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCursor\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"command\": \"npx\",\n      \"args\": [\"@tastehub/ckb\", \"mcp\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWindsurf\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"command\": \"npx\",\n      \"args\": [\"@tastehub/ckb\", \"mcp\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eVS Code\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to your VS Code `settings.json`:\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"ckb\": {\n        \"type\": \"stdio\",\n        \"command\": \"npx\",\n        \"args\": [\"@tastehub/ckb\", \"mcp\"]\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOpenCode\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to `opencode.json` in project root:\n```json\n{\n  \"mcp\": {\n    \"ckb\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"@tastehub/ckb\", \"mcp\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eGrok\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Auto-configure for current project\nnpx @tastehub/ckb setup --tool=grok\n\n# Or add globally\nnpx @tastehub/ckb setup --tool=grok --global\n```\n\nOr manually add to `.grok/settings.json` (project) or `~/.grok/user-settings.json` (global):\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"name\": \"ckb\",\n      \"transport\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"@tastehub/ckb\", \"mcp\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Desktop\u003c/strong\u003e\u003c/summary\u003e\n\nClaude Desktop doesn't have a project context, so you must specify the repository path.\n\n**Automatic setup** (recommended):\n```bash\ncd /path/to/your/repo\nckb setup --tool=claude-desktop\n```\n\n**Manual configuration** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tastehub/ckb\", \"mcp\"],\n      \"env\": {\n        \"CKB_REPO\": \"/path/to/your/repo\"\n      }\n    }\n  }\n}\n```\n\nThe `CKB_REPO` environment variable tells CKB which repository to analyze. Claude Desktop can only work with one repository at a time.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWindows\u003c/strong\u003e\u003c/summary\u003e\n\nUse `cmd /c` wrapper in any config above:\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"npx\", \"@tastehub/ckb\", \"mcp\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePresets (Token Optimization)\u003c/strong\u003e\u003c/summary\u003e\n\nCKB exposes 80+ tools, but most sessions only need a subset. Use presets to reduce token overhead by up to 83%:\n\n```bash\n# List all available presets with tool counts and token estimates\nckb mcp --list-presets\n\n# Default: core preset (14 essential tools)\nckb mcp\n\n# Workflow-specific presets\nckb mcp --preset=core        # 14 tools - search, explain, impact (default)\nckb mcp --preset=review      # 19 tools - core + diff, ownership\nckb mcp --preset=refactor    # 19 tools - core + coupling, dead code\nckb mcp --preset=federation  # 28 tools - core + cross-repo\nckb mcp --preset=docs        # 20 tools - core + doc-symbol linking\nckb mcp --preset=ops         # 25 tools - core + jobs, webhooks, metrics\nckb mcp --preset=full        # 80+ tools - all tools (legacy)\n```\n\nIn MCP config:\n```json\n{\n  \"mcpServers\": {\n    \"ckb\": {\n      \"command\": \"npx\",\n      \"args\": [\"@tastehub/ckb\", \"mcp\", \"--preset=review\"]\n    }\n  }\n}\n```\n\nThe AI can dynamically expand the toolset mid-session using the `expandToolset` tool.\n\n\u003c/details\u003e\n\n## Under the Hood\n\nCKB orchestrates multiple code intelligence backends:\n\n- **SCIP** — Precise, pre-indexed symbol data (fastest)\n- **LSP** — Real-time language server queries\n- **Git** — Blame, history, churn analysis, ownership\n\nResults are merged intelligently and compressed for LLM context limits.\n\nPersistent knowledge survives across sessions:\n- **Module Registry** — Boundaries, responsibilities, tags\n- **Ownership Registry** — CODEOWNERS + git-blame with time decay\n- **Hotspot Tracker** — Historical snapshots with trend analysis\n- **Decision Log** — ADRs with full-text search\n\n## Who Should Use CKB?\n\n- **Developers using AI assistants** — Give your AI tools superpowers\n- **Teams with large codebases** — Navigate complexity efficiently\n- **Anyone doing refactoring** — Understand impact before changing\n- **Code reviewers** — See the full picture of changes\n- **Tech leads** — Track architectural health over time\n\n## Limitations (Honest Take)\n\n**CKB excels at:**\n- Static code navigation—finding definitions, references, call graphs\n- Impact analysis for safe refactoring\n- Ownership lookup (CODEOWNERS + git blame)\n- Architecture and module understanding\n\n**CKB won't help with:**\n- Dynamic dispatch / runtime behavior (use debugger)\n- Generated code that isn't indexed\n- Code generation, linting, or formatting\n- Cross-repo calls (use [federation](https://github.com/SimplyLiz/CodeMCP/wiki/Federation) for this)\n\n\u003e CKB is static analysis, not magic. Always verify critical decisions by reading the actual code.\n\n📖 **[Practical Limits](https://github.com/SimplyLiz/CodeMCP/wiki/Practical-Limits)** — Full guide on accuracy, blind spots, and when to trust results\n\n## Documentation\n\nSee the **[Full Documentation Wiki](https://github.com/SimplyLiz/CodeMCP/wiki)** for:\n\n- [Quick Start](https://github.com/SimplyLiz/CodeMCP/wiki/Quick-Start) — Step-by-step installation\n- [Prompt Cookbook](https://github.com/SimplyLiz/CodeMCP/wiki/Prompt-Cookbook) — Real prompts for real problems\n- [Language Support](https://github.com/SimplyLiz/CodeMCP/wiki/Language-Support) — SCIP indexers and support tiers\n- [Practical Limits](https://github.com/SimplyLiz/CodeMCP/wiki/Practical-Limits) — Accuracy notes, blind spots\n- [User Guide](https://github.com/SimplyLiz/CodeMCP/wiki/User-Guide) — CLI commands and best practices\n- [Index Management](https://github.com/SimplyLiz/CodeMCP/wiki/Index-Management) — How indexing works, auto-refresh methods\n- [Incremental Indexing](https://github.com/SimplyLiz/CodeMCP/wiki/Incremental-Indexing) — Fast index updates for Go projects\n- [Doc-Symbol Linking](https://github.com/SimplyLiz/CodeMCP/wiki/Doc-Symbol-Linking) — Symbol detection in docs, staleness checking\n- [Authentication](https://github.com/SimplyLiz/CodeMCP/wiki/Authentication) — API tokens, scopes, rate limiting\n- [MCP Integration](https://github.com/SimplyLiz/CodeMCP/wiki/MCP-Integration) — Claude Code setup, 80+ tools\n- [API Reference](https://github.com/SimplyLiz/CodeMCP/wiki/API-Reference) — HTTP API documentation\n- [Daemon Mode](https://github.com/SimplyLiz/CodeMCP/wiki/Daemon-Mode) — Always-on service with scheduler, webhooks\n- [Configuration](https://github.com/SimplyLiz/CodeMCP/wiki/Configuration) — All options including MODULES.toml\n- [Architecture](https://github.com/SimplyLiz/CodeMCP/wiki/Architecture) — System design and components\n- [Security](https://github.com/SimplyLiz/CodeMCP/wiki/Security) — Secret detection, credential scanning\n- [Telemetry](https://github.com/SimplyLiz/CodeMCP/wiki/Telemetry) — Runtime observability, dead code detection\n- [Federation](https://github.com/SimplyLiz/CodeMCP/wiki/Federation) — Cross-repository queries\n- [CI/CD Integration](https://github.com/SimplyLiz/CodeMCP/wiki/CI-CD-Integration) — GitHub Actions, PR analysis\n\n## Requirements\n\n**Using npm (recommended):**\n- Node.js 16+\n- Git\n\n**Building from source:**\n- Go 1.21+\n- Git\n\n**Optional (for enhanced analysis):**\n- SCIP indexer for your language (scip-go, scip-typescript, etc.) — run `ckb index` to auto-install\n\n## License\n\n**Free for:**\n- Personal use\n- Open source projects\n- Startups \u0026 small businesses under $25k annual revenue\n\n**Commercial license required** for organizations with $25k+ annual revenue. See [pricing](https://codeknowledge.dev/pricing) for Team and Enterprise plans, or [LICENSE](LICENSE) for full terms.\n","funding_links":["https://github.com/sponsors/SimplyLiz"],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimplyLiz%2FCodeMCP","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSimplyLiz%2FCodeMCP","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimplyLiz%2FCodeMCP/lists"}