Ast MCP Server

🚀 AST MCP 服務器

AST MCP 服務器藉助抽象語法樹（AST）和抽象語義圖（ASG），為代碼提供結構和語義分析功能。它能解析代碼、生成語義圖、分析複雜度，支持多語言，還與 Claude 桌面版等 MCP 客戶端兼容，可高效處理大型文件。

✨ 主要特性

• 代碼解析：將代碼解析為抽象語法樹（AST），並從代碼生成抽象語義圖（ASG）。
• 代碼分析：分析代碼結構和複雜度，支持語法驗證。
• 多語言支持：支持多種編程語言，如 Python、JavaScript。
• 兼容性良好：與 Claude 桌面版和其他 MCP 客戶端兼容。
• 高效處理：採用增量解析，能更快處理大型文件。
• 語義分析增強：具備增強的作用域處理和更完整的語義分析。
• 版本變化識別：通過 AST 差分識別代碼版本之間的變化。
• 高級功能豐富：支持增量更新、作用域分析增強、跨語言調用圖生成和依賴關係分析。

📦 安裝指南

1. 克隆此倉庫：

git clone https://github.com/yourusername/ast-mcp-server.git
cd ast-mcp-server

2. 使用 uv 設置環境：

# 如果尚未安裝 uv，請先安裝
# pip install uv

# 創建並激活虛擬環境
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安裝依賴項
uv pip install -r requirements.txt

3. 構建解析器：

uv run build_parsers.py

💻 使用示例

與 Claude 桌面版配合使用

1. 配置 Claude 桌面版以使用該服務器。最簡單的方法是使用提供的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "AstAnalyzer": {
      "command": "uv",
      "args": [
        "--directory", "/absolute/path/to/ast-mcp-server",
        "run", "server.py"
      ]
    }
  }
}

2. 確保將 /absolute/path/to/ast-mcp-server 替換為您系統的實際絕對路徑。
3. 將此配置添加到您的 Claude 桌面版配置中：
   • 在 macOS 上：~/Library/Application Support/claude-desktop/claude_desktop_config.json
   • 在 Linux 上：~/.config/claude-desktop/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\claude-desktop\claude_desktop_config.json%
4. 重新啟動 Claude 桌面版以加載新的 MCP 服務器。
5. 在 Claude 桌面版中，現在可以使用基於 AST 的代碼分析工具了。

AST MCP 服務器運行正常。以下是經過驗證的功能摘要：

• 基本 AST 解析：✓
• 增量解析支持：✓
• 複雜度分析功能：✓

📚 詳細文檔

安裝步驟說明

如需安裝 AST MCP 服務器，請按照以下步驟操作：

1. 克隆倉庫到本地開發環境。
2. 使用 Python 虛擬環境管理工具 uv 創建並激活虛擬環境。
3. 在虛擬環境中安裝項目依賴項，包括 tree-sitter 語言支持庫和其他必要包。
4. 運行構建腳本以初始化所有支持的編程語言解析器。

與 Claude 桌面版集成

配置完成後，Claude 桌面版將能夠通過 MCP 協議訪問服務器提供的分析工具。用戶可以在聊天窗口中分享代碼片段，Claude 將利用這些工具進行深入分析並提供見解。

開發和測試

• 工具註冊：服務器在啟動時會自動註冊所有可用的工具和資源到 MCP 協議。
• 本地執行：所有工具執行都在用戶的本地設備上完成，結果返回給 Claude 進行解釋和展示。

可用工具

基本功能

1. 代碼解析為 AST
2. 生成對應的 ASG
3. 複雜度分析
4. 語法驗證

高級功能

1. 增量更新支持
2. 作用域分析增強
3. 跨語言調用圖生成
4. 依賴關係分析

添加更多語言支持

要添加新的編程語言支持，請執行以下步驟：

1. 在倉庫中添加新語言的 tree-sitter 語法定義文件。
2. 運行構建腳本 build_parsers.py 初始化解析器。
3. 更新工具註冊邏輯以包含新語言的支持。

工作原理

AST MCP 服務器通過 Model Context Protocol (MCP) 與 Claude 桌面版連接。啟動時：

1. 服務初始化：Claude 桌面版使用 uv run 啟動服務器，並指定工作目錄。
2. 加載解析器模塊：服務器加載 tree-sitter 語言模塊，以便支持多種編程語言的解析。
3. 註冊工具和資源：所有工具和資源被註冊到 MCP 協議中。
4. 分析執行：Claude 可以通過 MCP 協議調用這些工具對用戶分享的代碼進行分析。

📄 許可證

本項目採用 MIT 許可證。