Code Index MCP
An MCP server that lets AI assistants index, search, and analyze code repositories.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python>=3.10,uv
uv tool install code-index-mcp (puts code-index-mcp on PATH)
uv tool install code-index-mcp
Add it to your agent
claude mcp add code-index-mcp -- code-index-mcp --project-path '<project-path>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"code-index-mcp": {
"command": "code-index-mcp",
"args": [
"--project-path",
"<project-path>"
]
}
}
}Replace <project-path> with your own path.
Add code-index-mcp --project-path <your project> as an MCP server in your AI assistant, or run it over HTTP with `code-index-mcp --project-path <your project> --transport streamable-http --port <por
What it does
- Search code with regex and fuzzy matchingTested
How to use it
- Connect your assistant to
code-index-mcp --project-path <your project>. - Call the
search_code_advancedtool with apatternsuch as<your regex>andregexset to true.
- Connect your assistant to
- Parse code symbols in 10 languages with tree-sitterTested
How to use it
- Start
code-index-mcp --project-path <your project> --transport streamable-http --port <port>and connect your assistant tohttp://127.0.0.1:<port>/mcp. - Call the
build_deep_indextool. - Call
get_symbol_bodywith afile_pathand asymbol_nameto see that symbol's code.
- Start
- Summarize a file's structure and complexityTested
How to use it
- Start
code-index-mcp --project-path <your project> --transport streamable-http --port <port>and connect your assistant tohttp://127.0.0.1:<port>/mcp. - Call the
build_deep_indextool. - Call
get_file_summarywith thefile_pathof the file you want summarized.
- Start
- Refresh the index automatically when files changeNot shown working
How far pickfit got
Linux x86_64
- Installs
- Connects
- 3 of 4 features work
- Works offline
Good for
- find all places in a codebase that use an old API
- locate where a function is called
- search for error handling code while debugging
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
An MCP client handshake over stdio listed 14 tools, and a call to search_code_advanced returned a result.
Differences the test machine hit
- README: Run build_deep_index, then get_file_summary uses the deep index (the README says indexes are persistently cached).
In the test: When the server was started again over stdio in a separate process, it did not load the deep index built earlier: get_file_summary returned needs_deep_index (command 7) and get_symbol_body returned 'deep index not built' (command 8). To run several calls against one server, I started it with --tran… - README: Launch with uvx code-index-mcp
In the test: uv tool install code-index-mcp, then launch code-index-mcp (with --project-path to skip calling set_project_path). This lets it run with the network off.