Code Index MCP

What is Code Index MCP?

Code Index MCP is a Model Context Protocol server that enables large language models (LLMs) to index, search, and analyze code in project directories. It is intended for developers and AI assistants that need to navigate, search, and understand codebases.

How to use Code Index MCP?

Install Python 3.10+ and uv, clone the repository, then run uv run run.py. For Claude Desktop integration, add the server configuration to the Claude Desktop config file with the uv command and --directory pointing to the cloned folder. The first step is to set the project path via the LLM, after which you can search, analyze files, and navigate project structure.

Key features of Code Index MCP

• Index and navigate project file structures
• Search for specific patterns in code
• Get detailed file summaries
• Analyze code structure and complexity
• Support for multiple programming languages
• Persistent storage of project settings

Use cases of Code Index MCP

• Quickly find all occurrences of a function or variable in a large codebase
• Get a summary of all functions and classes in a specific file
• Explore the directory structure of an unfamiliar project
• Filter code search by file type (e.g., only Python or TypeScript files)

FAQ from Code Index MCP

What dependencies and runtime are required?

Python 3.10 or later and the uv package manager. All other dependencies are automatically handled by uv when running the server.

Where are index and settings data stored?

All data is stored in the .code_indexer folder inside the project directory, including config.json, file_index.pickle, and content_cache.pickle. This folder is gitignored to prevent committing indexing data.

Does the server support absolute paths or directory traversal?

No. Absolute path access is not allowed, and file path validation prevents directory traversal attacks. The project path must be explicitly set and has no default value.

What file types are supported for indexing and analysis?

The server supports Python, JavaScript/TypeScript, Java, C/C++, C#, Go, Ruby, PHP, Swift, Kotlin, Rust, Scala, Shell, HTML/CSS, Markdown, JSON, XML, and YAML files.

Can I use Code Index MCP with Claude Desktop?

Yes. Add the server configuration to Claude Desktop's config file with the uv run run.py command and the --directory option pointing to the correct project directory.