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 服務的話。由於其對代碼分析更簡單的處理方式，與更專業的工具相比，它可能更容易出錯或提供不太詳細的見解。

💡 使用建議

該工具適合高層次的代碼理解和探索，若需要更專業的代碼分析功能，建議使用更專業的工具。