johnhuang316/code-index-mcp

解决的问题

Code Index MCP 解决了 AI 助手在理解和导航复杂多语言代码库时的困难。它为 LLM 提供了一种结构化的方式，无需手动阅读每个文件，即可对代码符号和文件结构进行索引、搜索和分析。

工作原理

它作为 Model Context Protocol (MCP) 服务器运行，连接 AI 模型与本地文件系统。采用双策略索引架构：

• Tree-sitter AST 解析：为 10 种核心语言（包括 Python、TS、Rust 和 Go）提供深度原生语法解析，提取类、方法和调用关系。
• 降级策略：为超过 50 种其他文件类型提供基础索引。

服务器包含文件监视器，可实现实时索引更新，并与 ripgrep 或 ugrep 等原生搜索工具集成，支持高级正则和模糊搜索。

适用人群

本工具专为使用 MCP 兼容 AI 助手（如 Claude Desktop）的开发者设计，适用于需要帮助进行代码审查、重构、调试和大型项目架构分析的场景。

主要亮点

• 多语言支持：对 10 种语言提供专用 AST 解析，对 50+ 种文件类型提供基础支持。
• 实时监控：通过原生操作系统文件监视器实现自动索引更新。
• 深度分析：通过深度索引生成符号级元数据和复杂度指标。
• 灵活搜索：支持字面量、正则表达式和模糊匹配，结果支持分页。
• 持久缓存：将索引本地存储，实现后续访问的快速加载。