Dependency MCP

🚀 依賴關係 MCP 服務器

一個模型上下文協議 (MCP) 服務器，用於分析代碼庫以生成依賴圖和架構見解。該服務器可幫助開發者理解多種編程語言的代碼結構、依賴項和架構模式。

🚀 快速開始

依賴關係 MCP 服務器能有效分析代碼庫，生成依賴圖與架構見解。以下是使用前的安裝與配置步驟。

✨ 主要特性

• 多語言支持：可分析 TypeScript、JavaScript、C#、Python 等語言的依賴關係。
• 依賴圖生成：能生成詳細的依賴圖，支持 JSON 或 DOT 格式。
• 架構分析：可推斷架構層並驗證規則。
• 文件元數據：可提取導入、導出和其他文件信息。
• 評分系統：能評估代碼庫對架構規則和模式的符合程度。

📦 安裝指南

1. 克隆倉庫。
2. 安裝依賴：

npm install

3. 構建項目：

npm run build

📚 詳細文檔

配置

添加到 MCP 設置文件（通常位於 ~/.config/cline/mcp_settings.json 或類似路徑）：

{
  "mcpServers": {
    "DependencyMCP": {
      "command": "node",
      "args": ["path/to/dependency-mcp/dist/index.js"],
      "env": {
        "MAX_LINES_TO_READ": "1000",
        "CACHE_DIR": "path/to/dependency-mcp/.dependency-cache",
        "CACHE_TTL": "3600000"
      }
    }
  }
}

環境變量說明：

• MAX_LINES_TO_READ：每文件最大讀取行數（默認：1000）。
• CACHE_DIR：存儲依賴緩存的目錄（默認：.dependency-cache）。
• CACHE_TTL：緩存過期時間，單位為毫秒（默認：1 小時 = 3600000）。

已用工具

分析依賴關係

分析代碼庫中的依賴關係並生成依賴圖。

const result = await client.callTool("DependencyMCP", "analyze_dependencies", {
  path: "/path/to/project",
  excludePatterns: ["node_modules", "dist"], // 可選參數
  maxDepth: 10, // 可選參數
  fileTypes: [".ts", ".js", ".cs"] // 可選參數
});

獲取依賴圖

以 JSON 或 DOT 格式獲取代碼庫的依賴圖。

const result = await client.callTool("DependencyMCP", "get_dependency_graph", {
  path: "/path/to/project",
  format: "dot" // 或 "json"（默認）
});

獲取文件元數據

獲取特定文件的詳細信息。

const result = await client.callTool("DependencyMCP", "get_file_metadata", {
  path: "/path/to/file.ts"
});

架構評分

評估代碼庫對架構規則和模式的符合程度。

const result = await client.callTool("DependencyMCP", "architecture_score", {
  path: "/path/to/project"
});

輸出示例

依賴圖（JSON 格式）

{
  "nodes": [
    { "id": "1", "label": "main" },
    { "id": "2", "label": "dependencies" }
  ],
  "edges": [
    { "from": "1", "to": "2", "label": "depends-on" }
  ]
}

架構分數（JSON 格式）

{
  "score": 85,
  "description": "代碼庫符合 85% 的架構規則。"
}

🔧 技術細節

技術棧

• TypeScript
• Zod：用於類型安全配置。
• Diff：用於文件差異比較。
• Minimatch：用於文件模式匹配。

項目結構

dependency-mcp/
├── src/
│   ├── index.ts        # 入口文件
│   ├── graph.ts       # 圖生成邏輯
│   └── architecture.ts # 架構分析模塊
└── package.json      # 依賴管理文件

添加新語言

1. 更新 fileTypes 列表，包含新語言的文件擴展名。
2. 實現對新語言的支持，確保其正確解析和處理。

📄 許可證

本項目遵循 MIT 協議。