mcp-code-indexer

MCP.Pizza Chef: zxfgds

The MCP Code Indexer is a server designed to provide AI large language models with efficient and precise codebase retrieval capabilities. It uses semantic vector indexing and code structure analysis to enhance code understanding, quality evaluation, and dependency management. Supporting multi-language code search and full MCP protocol compliance, it enables intelligent code navigation, snippet extraction, and project-wide indexing with asynchronous operations and progress feedback.

Use This MCP server To

Perform semantic code search across multiple programming languages Analyze code structure including classes, functions, and dependencies Extract code snippets with full contextual understanding Evaluate code quality and detect similar code patterns Generate documentation from code comments and structure Visualize project dependencies and manage them effectively Support real-time code analysis in IDE extensions like VSCode Enable intelligent code navigation and refactoring assistance Provide asynchronous indexing with progress feedback Persist project indexing to avoid redundant processing

README

MCP代码索引器 (MCP Code Indexer)

基于模型上下文协议(Model Context Protocol)的智能代码检索工具,为AI大语言模型提供高效精确的代码库检索能力。

English Version

项目简介

MCP代码索引器是一个专为AI大语言模型设计的代码检索工具。它通过向量化索引和语义理解,帮助AI更好地理解和分析代码库,显著提升代码相关任务的处理效率和准确性。

项目地址:https://github.com/zxfgds/mcp-code-indexer

主要特性

  • 智能代码检索

    • 基于语义的代码搜索,理解代码含义而不仅是关键字匹配
    • 支持跨语言代码检索
    • 智能代码片段提取,自动识别完整的代码上下文
  • 代码分析能力

    • 代码结构分析(类、函数、依赖关系)
    • 代码质量评估
    • 文档和注释提取
    • 相似代码检测
    • 代码度量统计
    • 项目依赖分析
  • 优化的上下文处理

    • 智能Token消耗控制,减少不必要的上下文信息
    • 结构化的代码上下文提供
    • 多项目并行索引和检索支持
    • 持久化项目识别,避免重复索引
  • 完整MCP协议支持

    • 符合MCP数据交互规范
    • 提供丰富的工具集
    • 支持异步操作和进度反馈

应用场景

Claude Desktop应用

  • 增强代码理解:帮助Claude更准确地理解用户的代码库,提供更精准的建议和解答
  • 智能代码导航:快速定位相关代码片段,提高问答效率
  • 代码质量改进:通过代码分析功能,提供更专业的代码优化建议
  • 项目依赖管理:帮助理解和管理项目依赖关系
  • 文档生成辅助:基于代码注释和结构分析,协助生成技术文档

VSCode扩展

  • 实时代码分析:在编辑器中直接获取代码分析结果
  • 智能代码推荐:基于项目上下文提供更准确的代码建议
  • 重构辅助:识别可优化的代码模式,辅助代码重构
  • 依赖关系可视化:直观展示代码依赖关系
  • 团队协作增强:帮助团队成员更好地理解代码库

安装说明

  1. 安装依赖
pip install -r requirements.txt
  1. 安装工具
python setup.py install

配置说明

Claude Desktop配置

编辑配置文件:%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "code-indexer": {
      "command": "python",
      "args": ["-m", "server.app"],
      "cwd": "安装目录路径",
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

VSCode扩展配置

编辑配置文件:%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "code-indexer": {
      "command": "python",
      "args": ["-m", "server.app"],
      "cwd": "安装目录路径",
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

使用说明

基本功能

  1. 项目识别
使用identify_project工具识别项目
  1. 索引项目
使用index_project工具索引项目代码
  1. 搜索代码
使用search_code工具搜索相关代码片段

高级功能

  1. 获取代码结构
使用get_code_structure工具分析代码结构
  1. 分析代码质量
使用analyze_code_quality工具评估代码质量
  1. 提取文档
使用extract_documentation工具提取代码文档
  1. 查找相似代码
使用find_similar_code工具检测相似代码
  1. 获取代码度量
使用get_code_metrics工具获取代码统计数据
  1. 分析依赖关系
使用analyze_dependencies工具分析项目依赖

项目价值

  1. 提升AI代码理解能力

    • 更准确的代码语义理解
    • 更全面的项目上下文把握
    • 更智能的代码相关建议
  2. 优化开发体验

    • 减少重复工作
    • 提高代码质量
    • 加速开发流程
  3. 增强团队协作

    • 便于代码审查
    • 提升代码可维护性
    • 促进知识共享
  4. 降低资源消耗

    • 优化Token使用
    • 提高响应速度
    • 减少计算开销

贡献指南

欢迎提交Issue和代码贡献。

许可证

MIT License

mcp-code-indexer FAQ

How does MCP Code Indexer improve code search accuracy?
It uses semantic vector indexing and understanding rather than simple keyword matching, enabling more precise code retrieval.
Can MCP Code Indexer handle multiple programming languages?
Yes, it supports cross-language code retrieval and analysis.
Does MCP Code Indexer support integration with IDEs?
Yes, it can integrate with editors like VSCode to provide real-time code analysis and recommendations.
How does MCP Code Indexer manage large projects efficiently?
It supports multi-project parallel indexing, persistent project recognition, and optimized token consumption to reduce unnecessary context.
Is MCP Code Indexer compliant with the MCP protocol?
Yes, it fully supports MCP data interaction standards, asynchronous operations, and progress feedback.
What kind of code analysis features does MCP Code Indexer provide?
It offers code structure analysis, quality evaluation, similar code detection, and dependency analysis.
Can MCP Code Indexer assist in generating technical documentation?
Yes, it extracts documentation and comments to help generate technical docs.
How does MCP Code Indexer handle context for AI models?
It provides structured code context and controls token usage intelligently to optimize model input.
What benefits does MCP Code Indexer bring to AI models like Claude or GPT-4?
It enhances code understanding, navigation, and quality assessment, enabling more accurate AI-driven code tasks.
Does MCP Code Indexer support asynchronous operations?
Yes, it supports asynchronous indexing and retrieval with progress feedback.