code-intelligence-mcp

# Code Intelligence MCP Server A Model Context Protocol (MCP) server that indexes Python codebases and exposes intelligent tools for code exploration and search. ## Overview This server analyzes a Python project at startup, building an in-memory index that includes: - **AST parsing**: Extracts classes, functions, methods with signatures and docstrings - **Import tracking**: Maps what each file imports - **Usage tracking**: Finds where symbols are referenced throughout the codebase - **BM25 search**: Full-text keyword search across all code The indexed data powers 8 MCP tools that let an AI assistant navigate and query codebases semantically. ## Quick Start (uvx) Run directly without installing: ```powershell uvx code-intelligence-mcp --root D:\path\to\your\project ``` > **Note**: On Windows, use double backslashes or forward slashes for paths. ## Directory Structure ``` code_intelligence_mcp/ ├── main.py # Entry point - run this to start the server ├── mcp_client.py # Test client that connects to the server ├── pyproject.toml # Package configuration ├── README.md # This file ├── src/ │ ├── __init__.py # Package exports │ ├── __main__.py # Package entry point (for python -m src) │ ├── types.py # SymbolInfo, CodeIndex data classes │ ├── indexer.py # AST parsing and codebase indexing │ ├── search.py # BM25 search setup and search logic │ └── tools.py # MCP tool definitions (create_tools, handle_tool) └── code_intelligence.py # Original monolithic file (kept for reference) ``` ## Requirements - Python 3.12+ - `uv` package manager - Dependencies (installed in project virtual environment): - `langchain-mcp-adapters>=0.3.0` - `mcp>=1.27.2` - `rank-bm25>=0.2.2` ## Install Dependencies From the repo root: ```powershell uv add mcp rank-bm25 ``` If you already have them installed, skip this step. ## Run the MCP Server ### Option 1: u…