MCP Code Analyzer

MCP Code Analyzer

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

目前，项目中有许多错误，工具有时也无法按预期运行。由于工作繁忙， 我无法投入太多时间，但只要有空，我就会尽量修复问题，让它恢复正常运行。

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

概述

Model Context Protocol（MCP）Code Analyzer 是一款全面的代码分析与管理工具，可与 Claude Desktop 集成。它可以从项目和文件两个层面分析代码，为所需的变更和项目理解提供见解。

前提条件

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

安装

# Clone the repository
git clone https://github.com/[your-username]/mcp-code-analyzer.git
cd mcp-code-analyzer

# Install dependencies and package
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 许可，详情请参阅 LICENSE 文件。

---

注意：此项目正在积极开发中。功能和文档可能会频繁变更。