yacodebase-mcp

# yacodebase-mcp Vector search MCP server for codebases. Index repos locally with AST-aware chunking; let Claude (or any MCP client) search them semantically and query their structure. ## How it works 1. **Index** — walks repo files, chunks them using tree-sitter AST (function/method boundaries) with line-based fallback, embeds via OpenAI-compatible API, stores in in-process Qdrant. 2. **Serve** — exposes 12 MCP tools over stdio for search, structural analysis, and persistent knowledge. 3. **Search** — embeds the query, retrieves top-8 chunks across all indexed repos (or a specific one), returns ranked results with file path and line numbers. ## Install ```bash pip install yacodebase-mcp ``` Or from source: ```bash uv tool install /path/to/yacodebase-mcp ``` For development: ```bash uv sync ``` ## CLI ```bash # Show version yacodebase-mcp --version # Index a repo (fails if already indexed) yacodebase-mcp index ~/Code/myproject # Re-index after changes (replaces existing index) yacodebase-mcp reindex ~/Code/myproject # Incrementally update index (only changed files) yacodebase-mcp update ~/Code/myproject # List indexed repos with chunk counts yacodebase-mcp list # Remove a repo from the index yacodebase-mcp remove ~/Code/myproject # Start MCP server (stdio, used by Claude Code) yacodebase-mcp serve ``` ### Config commands ```bash # Show current settings yacodebase-mcp config list # Set embedding model (known models auto-resolve vector size) yacodebase-mcp config set embedding-model text-embedding-3-large yacodebase-mcp config set embedding-model my-custom-model --vector-size 768 # Set API credentials yacodebase-mcp config set api-key sk-... yacodebase-mcp config set api-base https://my-provider.com/v1 # Revert a setting to default / env var fallback yacodebase-mcp config unset embedding-model yacodebase-mcp config unset api-key yacodebase-mcp config unset api-base ``` **Known models** (vector size auto-detected): | Model | Vector size | |---|…