Code Analysis Server

🚀 代码分析 MCP 服务器

一个模型上下文协议 (MCP) 服务器，可让 AI 模型通过自然语言对话理解和分析代码库，为开发者提供便捷的代码探索和理解方式。

🚀 快速开始

1. 安装服务器：

git clone https://github.com/saiprashanths/code-analysis-mcp.git
cd code-analysis-mcp

2. 安装 Claude 桌面应用。有关使用 Claude 桌面应用程序设置 MCP 服务器的更多说明，请参见文档。
3. 配置你的项目：

{
  "projectName": "我的项目",
  "description": "这是一个用于代码分析的示例项目。",
  "ignorePaths": ["\\.git", "node_modules"],
  "maxFileSize": "1MB",
  "maxLinesPerFile": "1000"
}

4. 启动服务器：

python3 server.py

✨ 主要特性

• 自然代码探索：可提出高层次的问题来了解代码库，例如：

  "系统中集成了哪些不同的支付提供方？"
  

• 深度代码理解：能够提取数据模型和系统架构的洞察，例如：

  "从前端到数据库，用户身份验证流程是怎样的？"
  

• 动态分析：可以跟踪数据流并了解系统关系，例如：

  "显示我们计算交易费用的所有地方"
  

📦 安装指南

1. 安装服务器：

git clone https://github.com/saiprashanths/code-analysis-mcp.git
cd code-analysis-mcp

2. 安装 Claude 桌面应用。有关使用 Claude 桌面应用程序设置 MCP 服务器的更多说明，请参见文档。
3. 配置你的项目：

{
  "projectName": "我的项目",
  "description": "这是一个用于代码分析的示例项目。",
  "ignorePaths": ["\\.git", "node_modules"],
  "maxFileSize": "1MB",
  "maxLinesPerFile": "1000"
}

4. 启动服务器：

python3 server.py

💻 使用示例

基础用法

项目结构扫描

运行 scan-filesystem 命令以查看文件结构：

node src/cli/scan-filesystem.js --path "src/api"
# 输出:
# 正在扫描目录：src/api
# 发现文件：models.py (2.3KB)
# 发现文件：helpers.js (156KB)
# 扫描完成，发现 2 个文件。

分析特定文件

使用 analyze-file 命令来分析具体文件：

node src/cli/analyze-file.js --path "src/api/models.py"
# 输出:
# 正在分析文件：src/api/models.py
# 文件语言：Python
# 文件大小：2.3KB
# 内容摘要：包含用户和订单模型的定义。

与 Claude 交互

通过以下命令与 Claude 对话：

node src/cli/chat.js --project "我的项目"
# 输入:
# Claude: 欢迎！我是代码分析助手。请问有什么可以帮助你的？
# User: 我们的系统中有哪些主要的支付方式？
# Claude: 根据代码库，我发现了以下支付提供方：Stripe、PayPal 和支付宝。

🔧 技术细节

• 默认扫描深度：3 级
• 最大文件大小：1MB
• 每个文件的最大行数：1000
• 忽略 .gitignore 中列出的路径
• 仅限本地文件系统访问
• 验证文件路径以防止目录遍历

📄 许可证

本项目 licensed under the MIT License - 查看 LICENSE 文件获取详细信息。

⚠️ 重要提示

此工具是一个更简单代码分析工具（如 Aider）的替代品。虽然它缺乏更专业的代码分析功能和 Aider 的健壮性，但它为代码库探索提供了一个轻量级解决方案，如果你已经订阅了 Claude Pro 服务的话。由于其对代码分析更简单的处理方式，与更专业的工具相比，它可能更容易出错或提供不太详细的见解。

💡 使用建议

该工具适合高层次的代码理解和探索，若需要更专业的代码分析功能，建议使用更专业的工具。