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文件。