Code Analysis

🚀 代碼分析 MCP 插件

這是一個模型上下文協議（MCP）插件，藉助 Neo4j 圖數據庫，讓 Cline 和 Claude 這類 AI 助手能直接訪問代碼庫，開展高級代碼分析工作，並精準回答與代碼庫相關的問題。

🚀 快速開始

有關開發環境設置，請參閱CONTRIBUTING.md。

✨ 主要特性

代碼結構分析

• 清晰呈現組件和模塊之間的關係。
• 精準梳理類層次結構和依賴性。
• 深入分析方法複雜度及相互關係。
• 全面掌握文件組織與導入情況。

代碼質量指標

• 嚴密性複雜度（Cyclomatic Complexity）評估。
• 耦合性和內聚性指標分析。
• 代碼重複檢測，及時發現冗餘。
• 測試覆蓋率分析，保障代碼質量。

文檔分析

• 高效解析 Markdown 文件。
• 科學評估文檔質量指標。
• 細緻分析文檔覆蓋範圍。
• 具備自動化文檔更新功能。

天然語言查詢（Natural Language Queries）

• 支持提問代碼結構相關問題。
• 可製作包含對象圖和序列圖等可視化工具的高層次架構概述。
• 精準識別潛在代碼問題。
• 快速找到相關的代碼示例。

💻 使用示例

基礎用法

以下是使用該插件向 AI 助手提問的示例：

# 提問代碼庫關鍵功能與特性總結
question1 = "請總結此代碼庫的關鍵功能與特性"

# 提問生成高層次設計文檔
question2 = "編寫一份包含對象圖和序列圖的高層次設計文檔"

# 提問概述代碼庫關鍵組件
question3 = "概述代碼庫中的關鍵組件，每個組件用一段或兩段描述"

# 提問分析棘手文件
question4 = "有哪些較為棘手的文件？從SOLID原則和清潔編碼的角度進行分析"

高級用法

在實際應用中，你可以結合多個問題進行復雜的代碼分析。例如，先獲取代碼庫的關鍵組件概述，再針對某個組件深入分析其代碼質量：

# 先獲取關鍵組件概述
component_overview_question = "概述代碼庫中的關鍵組件，每個組件用一段或兩段描述"
# 假設得到組件 A 是關鍵組件之一
# 再分析組件 A 的代碼質量
component_a_quality_question = "分析組件 A 的嚴密性複雜度、耦合性和內聚性指標"

📚 詳細文檔

該插件可以回答如下問題：

• “請總結此代碼庫的關鍵功能與特性”
• “編寫一份包含對象圖和序列圖的高層次設計文檔”
• “概述代碼庫中的關鍵組件，每個組件用一段或兩段描述”
• “有哪些較為棘手的文件？從SOLID原則和清潔編碼的角度進行分析”

🔧 技術細節

該插件採用以下技術：

• Neo4j 圖數據庫存儲代碼結構與關係。
• 各編程語言專用解析器用於代碼分析。
• MCP 接口實現 AI 助手集成。
• 高級度量計算方法進行代碼質量評估。

📄 許可證

本項目在 MIT 許可證下開源，具體許可內容請查閱LICENSE文件。