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。