DependencyMCP Server

DependencyMCP サーバー

コードベースを分析し、依存関係グラフとアーキテクチャに関する分析情報を生成する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、複数のプログラミング言語にわたるコード構造、依存関係、アーキテクチャパターンを把握できます。

機能

• マルチ言語サポート：TypeScript、JavaScript、C#、Python などの依存関係を分析します
• 依存関係グラフの生成：JSON または DOT 形式で詳細な依存関係グラフを作成します
• アーキテクチャ分析：アーキテクチャのレイヤーを推定し、ルールに照らして検証します
• ファイルメタデータ：ソースファイルからインポート、エクスポート、その他のメタデータを抽出します
• スコアリングシステム：アーキテクチャのルールやパターンに照らしてコードベースを評価します

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

設定

MCP 設定ファイル（通常は ~/.config/cline/mcp_settings.json または同等の場所にあります）に追加します：

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）

利用可能なツール

analyze_dependencies

コードベースの依存関係を分析し、依存関係グラフを生成します。

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

get_dependency_graph

コードベースの依存関係グラフを JSON または DOT 形式で取得します。

const result = await client.callTool("DependencyMCP", "get_dependency_graph", {
  path: "/path/to/project",
  format: "dot" // or "json" (default)
});

get_file_metadata

特定のファイルに関する詳細なメタデータを取得します。

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

get_architectural_score

アーキテクチャのルールやパターンに照らしてコードベースをスコアリングします。

const result = await client.callTool("DependencyMCP", "get_architectural_score", {
  path: "/path/to/project",
  rules: [
    {
      pattern: "src/domain/**/*",
      allowed: ["src/domain/**/*"],
      forbidden: ["src/infrastructure/**/*"]
    }
  ]
});

出力例

依存関係グラフ（JSON）

{
  "src/index.ts": {
    "path": "src/index.ts",
    "imports": ["./utils", "./services/parser"],
    "exports": ["analyze", "generateGraph"],
    "namespaces": [],
    "architecturalLayer": "Infrastructure",
    "dependencies": ["src/utils.ts", "src/services/parser.ts"],
    "dependents": []
  }
}

アーキテクチャスコア

{
  "score": 85,
  "violations": [
    "src/domain/user.ts -> src/infrastructure/database.ts violates architectural rules"
  ],
  "details": "Score starts at 100 and deducts 5 points per violation"
}

開発

このサーバーは TypeScript で構築されており、以下を使用します：

• スキーマ検証用の Zod
• ファイル比較用の diff
• glob パターンマッチング用の minimatch

プロジェクト構成

dependency-mcp/
├── src/
│   └── index.mts    # Main server implementation
├── package.json
├── tsconfig.json
└── README.md

新しい言語のサポートを追加する

新しいプログラミング言語のサポートを追加するには：

1. デフォルトの fileTypes 配列にファイル拡張子を追加します
2. parseFileImports と parseFileExports に言語固有の正規表現パターンを実装します
3. inferArchitecturalLayer に言語固有のアーキテクチャパターンを追加します

ライセンス

MIT