Code Index MCP Server

Content

Code Index MCP is a local code-aware MCP server for indexing repositories and answering project navigation questions. It lets an AI assistant set a project path, refresh shallow file indexes, build deeper symbol indexes, search code, find files, inspect file summaries, retrieve symbol bodies, and monitor file watcher status.

Use it when a coding agent needs fast, repeatable local context from a specific repository without granting a broader shell or editor-control server. It is best configured with an explicit project path and reviewed exclude patterns so only the intended source tree is indexed.

Source Review

• https://github.com/johnhuang316/code-index-mcp
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/README.md
• https://pypi.org/pypi/code-index-mcp/json
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/LICENSE
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/pyproject.toml
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/src/code_index_mcp/server.py
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/.well-known/mcp.json
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/fastmcp.json
• https://raw.githubusercontent.com/johnhuang316/code-index-mcp/master/docs/mcp-restart-playbook.md

These sources were reviewed on 2026-06-06. Prefer the live repository, README, PyPI metadata, license, package metadata, MCP server implementation, well-known MCP manifest, FastMCP config, and restart playbook for current setup and operation details.

Features

• Set or bootstrap a project path for repository-specific indexing.
• Build shallow file indexes and optional deep symbol indexes.
• Search code with native search backends such as ugrep, ripgrep, ag, or grep when available.
• Find files through glob patterns.
• Summarize files, imports, symbols, methods, functions, and complexity data.
• Retrieve symbol bodies after building a deep index.
• Monitor file changes and configure watcher behavior.
• Store indexes and settings in temp/index directories.
• Support tree-sitter strategies for Python, JavaScript, TypeScript, Java, Kotlin, C#, Go, Objective-C, Zig, and Rust, with fallback handling for many other file types.
• Publish .well-known and FastMCP metadata for clients that can import MCP manifests.

Installation

Run with uvx and an explicit project path:

uvx code-index-mcp --project-path ABSOLUTE_PATH_TO_REPOSITORY

Add it to an MCP client:

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

You can also start without --project-path and call the set_project_path tool after launch, but an explicit startup path is easier to audit.

Use Cases

• Find all files or functions related to a feature before editing.
• Search for deprecated APIs, TODOs, config keys, routes, or error handling.
• Summarize a file's imports, symbols, functions, and structural complexity.
• Build a deep index before asking where a symbol is defined or used.
• Keep a coding session's repository context fresh after file changes.
• Compare project structure across Python, TypeScript, Java, Go, Rust, C#, and other mixed-language repositories.

Safety and Privacy

Code Index MCP is read-oriented, but it still grants the model visibility into local source code and derived repository metadata. Scope it to one repository, review exclude patterns, and avoid indexing generated artifacts, vendored dependencies, secret stores, customer data, or unrelated sibling projects.

Remember that search snippets and summaries can contain secrets if the repository contains secrets. Treat MCP results as repository data, especially when the MCP client sends tool output to a remote model provider.

Duplicate Notes

Existing catalog entries cover semantic code agents, graph-backed context servers, and token-efficient code search tools. This entry covers the separate johnhuang316/code-index-mcp Python package and its local repository indexing, file discovery, watcher refresh, and symbol-summary workflow.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationraw.githubusercontent.com
• Submitted by oktofeesh12026-06-06