MCP Code Analyzer

🚀 MCP 代码分析器

MCP 代码分析器是一款与 Claude Desktop 集成的代码分析和管理工具，能从项目和文件层面分析代码，为项目更改和理解提供有价值的见解。

🚀 快速开始

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

目前，项目中存在许多 bug，并且工具有时无法正常工作。由于工作安排，我暂时没有太多时间修复问题，但我将尽力解决问题并使工具处于可工作的状态。

⚠️ 重要提示

此工具执行文件操作，可能会修改或删除文件。在使用任何修改功能之前，请始终备份代码库。

✨ 主要特性

• 与 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. Chat上下文限制可能中断对大文件的修改
2. AI生成的文档注释可能会影响大型文件中的代码操作

演示视频

观看使用MCP工具与构建马里奥游戏的演示：

注意：此视频展示了工具的功能，而不是完整的教程。虽然由于Claude的消息限制，游戏无法完全玩，但该视频展示了MCP工具的工作原理及可执行的操作。

📄 许可证

此项目根据 MIT License 分发 - 有关详细信息，请参阅 文件。

💡 使用建议

欢迎贡献！无论是 bug 报告、功能请求、文档改进还是代码贡献——每一份贡献都很重要。只需 fork 仓库并提交pull request。