Code Index MCP is an intelligent code analysis engine that indexes and searches code repositories to help AI assistants understand project structure, find relevant files, and analyze code patterns. Key features of Code Index MCP: - Intelligent indexing of code repositories with automatic parsing of file structure and dependencies - Advanced text-based search across the entire codebase to locate functions, classes, variables, and patterns - File discovery by type or programming language (TypeScript, Python, etc.) - Detailed analysis of individual files to understand code structure, imports, and relationships - Easy integration with Claude Desktop, Codex CLI, and other MCP-compatible tools through Python 3.10+ and uv

Code Index MCP

[](https://modelcontextprotocol.io) [](https://www.python.org/) [](LICENSE)

Intelligent code indexing and analysis for Large Language Models

Transform how AI understands your codebase with advanced search, analysis, and navigation capabilities.

Overview

Code Index MCP is a Model Context Protocol server that bridges the gap between AI models and complex codebases. It provides intelligent indexing, advanced search capabilities, and detailed code analysis to help AI assistants understand and navigate your projects effectively.

Perfect for: Code review, refactoring, documentation generation, debugging assistance, and architectural analysis.

Quick Start

🚀 Recommended Setup (Most Users)

The easiest way to get started with any MCP-compatible application:

Prerequisites: Python 3.10+ and uv

1. Add to your MCP configuration (e.g., claude_desktop_config.json or ~/.claude.json):

   {
     "mcpServers": {
       "code-index": {
         "command": "uvx",
         "args": ["code-index-mcp"]
       }
     }
   }
   

2. Restart your application – uvx automatically handles installation and execution

3. Start using (give these prompts to your AI assistant):

   Set the project path to /Users/dev/my-react-app
   Find all TypeScript files in this project  
   Search for "authentication" functions
   Analyze the main App.tsx file
   

Codex CLI Configuration

If you are using Anthropic's Codex CLI, add the server to ~/.codex/config.toml. On Windows the file lives at C:\Users\\.codex\config.toml:

[mcp_servers.code-index]
type = "stdio"
command = "uvx"
args = ["code-index-mcp"]

On Windows, uvx needs the standard profile directories to be present. Keep the environment override in the same block so the MCP starts reliably:

env = {
  HOME = "C:\\Users\\",
  APPDATA = "C:\\Users\\\\AppData\\Roaming",
  LOCALAPPDATA = "C:\\Users\\\\AppData\\Local",
  SystemRoot = "C:\\Windows"
}

Linux and macOS already expose the required XDG paths and HOME, so you can usually omit the env table there. Add overrides only if you run the CLI inside a restricted container.

FastMCP & Discovery Manifests

When sharing the manifests, remind consumers to supply --project-path (or to call set_project_path) so the server indexes the intended repository.

Typical Use Cases

Code Review: "Find all places using the old API" Refactoring Help: "Where is this function called?" Learning Projects: "Show me the main components of this React project" Debugging: "Search for all error handling related code"

Key Features

🔍 Intelligent Search & Analysis