codetex-mcp

# codetex-mcp A commit-aware code context manager for LLMs. Indexes Git repositories into a multi-tier knowledge hierarchy — repo overviews, file summaries, and symbol details — stored in SQLite with vector search. Serves context to LLM clients via the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) or a local CLI. ## What It Does codetex builds a structured, searchable index of your codebase that LLMs can query on demand: - **Tier 1 — Repo Overview:** Purpose, architecture, directory structure, key technologies, entry points - **Tier 2 — File Summaries:** Per-file purpose, public interfaces, dependencies, roles - **Tier 3 — Symbol Details:** Function/class signatures, parameters, return types, call relationships Summaries are generated by an LLM (Anthropic Claude). Embeddings are computed locally with [sentence-transformers](https://www.sbert.net/) for semantic search. Everything is stored in a single SQLite database with [sqlite-vec](https://github.com/asg017/sqlite-vec) for vector queries. Incremental sync means only changed files are re-analyzed when you update your code. ## Requirements - Python 3.12+ - Git - An [Anthropic API key](https://console.anthropic.com/) (for indexing) ## Installation ```bash # With pip pip install codetex-mcp # With uv (recommended) uv tool install codetex-mcp ``` ## Quick Start ### 1. Set your Anthropic API key ```bash # Via environment variable export ANTHROPIC_API_KEY=sk-ant-... # Or via config codetex config set llm.api_key sk-ant-... ``` ### 2. Add a repository ```bash # Local repo codetex add /path/to/your/project # Remote repo (clones to ~/.codetex/repos/) codetex add https://github.com/user/repo.git ``` ### 3. Index it ```bash # Preview what indexing will cost (no API calls) codetex index my-project --dry-run # Build the full index codetex index my-project ``` ### 4. Query your codebase ```bash # Repo overview (Tier 1) codetex context my-project # File summary (Tier 2) codetex context …