Dependency 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 ライセンスに従います。