MCP 代码分析器

MCP 工具的主要目的是智能地适应项目中的更改。例如，当需要代码修改或结构调整时，它旨在确保其他相关的用法也相应地更新。

目前，该项目有很多错误，并且这些工具有时无法按预期运行。由于工作繁忙，我无法投入太多时间，但我会尽量修复这些问题，并在有时间时使其恢复到工作状态。

⚠️ 警告：建议备份 此工具执行文件操作，可能会修改或删除文件。在使用任何修改功能之前，请务必备份您的代码库。

概述

模型上下文协议 (MCP) 代码分析器是一个综合性的代码分析和管理工具，它与 Claude Desktop 集成。它在项目和文件级别分析代码，为所需的更改和项目理解提供见解。

前提条件

• Python 3.10 或更高版本
• Windows（尚未测试 Linux/MacOS 支持）

安装

# 克隆仓库
git clone https://github.com/[your-username]/mcp-code-analyzer.git
cd mcp-code-analyzer

# 安装依赖和打包
pip install -e .

Claude Desktop 集成

配置

1. 访问 Claude Desktop 配置：

   Win + R → %AppData%\Claude\
   

2. 创建/编辑 claude_desktop_config.json：

   {
     "globalShortcut": "Ctrl+Space",
     "mcpServers": {
       "code-analyzer": {
         "command": "python",
         "args": [
           "-m",
           "mcp_code_analyzer",
           "--analyze-paths",
           "C:\\Projects\\path1"
         ],
         "type": "module"
       }
     }
   }
   

路径配置

• 可以在配置中指定多个项目路径
• 可以通过聊天消息分析其他路径或文件
• 可分析的路径/文件数量没有限制

🛠️ 工具和状态

可用工具

• ✅ 项目分析

  • analyze_project_structure (XML 树格式)
  • analyze_project_statistics
  • analyze_project_technology
  • analyze_code_structure

• ✅ 代码分析

  • analyze_imports
  • analyze_file
  • find_references

• ⚠️🔄 文件操作 (使用前务必备份)

  • file_operations
  • version_control (创建带日期的备份)

• ⚠️🔄 代码修改 (使用前务必备份)

  • code_modifier (逐行执行代码修改)(目前存在重大问题)

测试阶段

• 🔄 check_syntax
• 🔄 find_code_patterns
• 🔄 find_pattern_usages
• 🔄 search_content
• 🔄 search_files
• 🔄 validate_code

已知问题

1. 聊天上下文限制可能会中断大型文件的修改
2. AI 生成的文档注释可能会影响大型文件中的代码操作

演示视频

观看使用 MCP 工具构建 Mario 游戏的演示：

注意：这是该工具功能的演示，而不是完整的游戏教程。虽然由于 Claude 的消息限制，该游戏无法完全运行，但此视频展示了 MCP 工具的工作方式以及您可以使用它做什么。

贡献

欢迎贡献！无论是错误报告、功能请求、文档改进还是代码贡献 - 每一项贡献都有帮助。只需 fork 存储库并提交 pull request。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

---

注意：此项目正在积极开发中。功能和文档可能会经常更改。