Dependency MCP

🚀 Dependency MCP Server

Dependency MCP Serverは、複数のパッケージマネージャーとレジストリを横断してパッケージのバージョンをチェックするためのModel Context Protocol (MCP)サーバーです。このサーバーを使用することで、様々なプログラミング言語のパッケージの最新バージョンや特定バージョンの存在を簡単に確認できます。

✨ 主な機能

• 多言語対応：NPM、PyPI、Maven、NuGet、RubyGems、Crates.io、Goモジュールのパッケージをチェックできます。
• 最新バージョンの検索：任意のパッケージの最新バージョンを取得できます。
• バージョンの存在確認：特定のバージョンが存在するかどうかを確認できます。
• パッケージ情報の取得：全バージョンを含む詳細なパッケージメタデータを取得できます。
• バッチ処理：複数のパッケージを同時にチェックし、効率を向上させます。
• 簡単なインストール：npxを介してインストールして実行できます。

📦 インストール

グローバルインストール

npm install -g dependency-mcp

npxで実行（インストール不要）

npx dependency-mcp

ローカル開発

git clone <repository>
cd dependency-mcp
npm install
npm start

💻 使用例

基本的な使用法

このサーバーはMCPサーバーとしてstdioトランスポートを使用して実行され、MCP互換のクライアントと一緒に使用するように設計されています。

利用可能なツール

単一パッケージ用ツール

1 - 2個のパッケージをチェックする場合や、詳細な情報が必要な場合に使用します。

1. get_latest_version

パッケージの最新バージョンを取得します。依存関係の更新、バージョンチェック、または最新の安定リリースが必要な場合に使用します。 パラメータ:

• package_name (文字列): パッケージの名前
• registry (文字列): パッケージレジストリ (npm, pypi, maven, nuget, rubygems, crates, go) 例:

{
  "package_name": "express",
  "registry": "npm"
}

2. check_version_exists

特定のバージョンが存在するかどうかを確認します。依存関係の検証、CI/CDチェック、またはバージョンの互換性を確保する場合に使用します。 パラメータ:

• package_name (文字列): パッケージの名前
• version (文字列): チェックするバージョン
• registry (文字列): パッケージレジストリ 例:

{
  "package_name": "flask",
  "version": "2.3.0",
  "registry": "pypi"
}

3. get_package_info

全バージョンを含む詳細なパッケージ情報を取得します。依存関係の監査、セキュリティレビュー、または包括的なパッケージメタデータが必要な場合に使用します。 パラメータ:

• package_name (文字列): パッケージの名前
• registry (文字列): パッケージレジストリ 例:

{
  "package_name": "lodash",
  "registry": "npm"
}

複数パッケージ用ツール

3個以上のパッケージをチェックする場合や、一括操作を行う場合に使用します。

4. get_latest_versions

複数のパッケージの最新バージョンを同時に取得します。3個以上の依存関係をチェックする場合に使用し、最大100個のパッケージを並列に処理します。 パラメータ:

• packages (配列): パッケージ名の配列
• registry (文字列): パッケージレジストリ 例:

{
  "packages": ["react", "lodash", "axios"],
  "registry": "npm"
}

5. check_versions_exist

複数のパッケージについて特定のバージョンが存在するかどうかを確認します。一括依存関係の検証、CI/CDパイプラインのチェック、または複数のパッケージのバージョン互換性を確保する場合に使用します。 パラメータ:

• packages (配列): package_name と version を持つパッケージオブジェクトの配列
• registry (文字列): パッケージレジストリ 例:

{
  "packages": [
    { "package_name": "react", "version": "18.2.0" },
    { "package_name": "lodash", "version": "4.17.21" },
    { "package_name": "axios", "version": "1.6.0" }
  ],
  "registry": "npm"
}

6. get_packages_info

複数のパッケージについて包括的なパッケージ詳細を取得します。依存関係の監査、セキュリティレビュー、または一括パッケージ分析に使用します。 パラメータ:

• packages (配列): パッケージ名の配列
• registry (文字列): パッケージレジストリ 例:

{
  "packages": ["react", "lodash", "axios"],
  "registry": "npm"
}

📚 ドキュメント

ツール選択ガイド

単一パッケージ用ツールを使用する場合

• チェックするパッケージが 1 - 2個 の場合
• 詳細な情報（バージョン、ホームページ、リポジトリ）が必要な場合
• 1つのパッケージについて 特定のバージョンの検証 が必要な場合
• 開発中の 迅速なチェック が必要な場合

複数パッケージ用ツールを使用する場合

• チェックするパッケージが 3個以上 の場合
• 一括依存関係の検証 が必要な場合
• CI/CDパイプラインのチェック が必要な場合
• 依存関係の監査 またはセキュリティレビューが必要な場合
• 複数のパッケージが関係する パフォーマンスが重要な シナリオの場合

パフォーマンスに関する注意事項

• 単一パッケージ用ツール：1 - 2個のパッケージの場合に高速です。
• 複数パッケージ用ツール：並列処理により、5個以上のパッケージの場合に3 - 5倍高速です。
• エラー分離：失敗したパッケージはバッチ全体を破壊しません。
• バッチ制限：リクエストごとの最大パッケージ数は100個です。

バッチ処理

複数パッケージ用ツールは、複数のパッケージをチェックする際に大幅なパフォーマンス向上を提供します。

利点

• 往復遅延の排除：1つのリクエストで最大100個のパッケージをチェックできます。
• 一貫したエラー処理：個々のパッケージの失敗はバッチ全体を破壊しません。
• 並列処理：すべてのパッケージが同時にチェックされ、最大限の効率を実現します。
• APIオーバーヘッドの削減：外部レジストリへのHTTPリクエストが減少します。

制限事項

• 最大バッチサイズ：リクエストごとに最大100個のパッケージ。
• レート制限：外部APIを圧倒しないように、組み込みの遅延があります。
• タイムアウト処理：リクエストごとに10秒のタイムアウトがあり、グレースフルなフォールバックが行われます。
• メモリ使用量：大きなバッチはより多くのメモリを消費する場合があります。

バッチツールを使用する場合

• 依存関係の監査：プロジェクト内の複数のパッケージをチェックする場合
• バージョン比較：複数のパッケージ間でバージョンを比較する場合
• 一括更新：どのパッケージに新しいバージョンがあるかを特定する場合
• CI/CDパイプライン：複数のパッケージのバージョンを同時に検証する場合

本番環境での考慮事項

パフォーマンス

• 並列処理：複数パッケージ用ツールはPromise.allを使用して並列実行します。
• レート制限：外部APIへのリクエスト間に100msの組み込み遅延があります。
• タイムアウト処理：10秒のタイムアウトでグレースフルなエラー処理が行われます。
• メモリ管理：大きなバッチを効率的に処理します。

信頼性

• エラー分離：個々のパッケージの失敗はバッチ内の他のパッケージに影響しません。
• ネットワーク回復力：一時的なネットワーク問題をグレースフルに処理します。
• APIフォールバック：外部APIが利用できない場合にグレースフルに劣化します。
• 検証：包括的な入力検証により、無効なリクエストを防止します。
• レジストリ固有の処理：Mavenレジストリは一部のネットワーク環境で遅くなる場合があります。

セキュリティ

• 入力サニタイズ：すべての入力が検証され、サニタイズされます。
• レート制限：外部APIの乱用を防止します。
• エラーメッセージ：内部詳細を公開しない安全なエラーメッセージが返されます。
• タイムアウト保護：ハングリクエストを防止します。

監視

• タイムスタンプ：すべてのレスポンスにISOタイムスタンプが含まれ、追跡が可能です。
• エラー追跡：デバッグ用の詳細なエラー情報が提供されます。
• パフォーマンスメトリクス：組み込みのタイムアウトとレート制限の追跡が行われます。

Claude Desktopでの設定

Claude Desktopの設定ファイルに以下を追加します。

Windows

%APPDATA%\Claude\claude_desktop_config.json

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Linux

~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "dependency-checker": {
      "command": "npx",
      "args": ["dependency-mcp"]
    }
  }
}

応答例

最新バージョンの応答

{
  "package": "express",
  "registry": "npm",
  "found": true,
  "latest_version": "4.18.2",
  "description": "Fast, unopinionated, minimalist web framework"
}

バージョンチェックの応答

{
  "package": "flask",
  "version": "2.3.0",
  "registry": "pypi",
  "exists": true
}

パッケージ情報の応答

{
  "package": "lodash",
  "registry": "npm",
  "found": true,
  "latest_version": "4.17.21",
  "description": "Lodash modular utilities.",
  "versions": ["4.17.21", "4.17.20", "..."],
  "homepage": "https://lodash.com/",
  "repository": "git+https://github.com/lodash/lodash.git"
}

特殊フォーマットに関する注意事項

Maven

Mavenパッケージは groupId:artifactId の形式で指定する必要があります。

{
  "package_name": "org.springframework:spring-core",
  "registry": "maven"
}

Goモジュール

Goモジュールは完全なモジュールパスを使用する必要があります。

{
  "package_name": "github.com/gorilla/mux",
  "registry": "go"
}

エラー処理

サーバーは一般的なシナリオに対して詳細なエラーメッセージを提供します。

• パッケージが見つからない場合
• ネットワーク接続問題
• 無効なパッケージ名の形式
• レジストリAPIのエラー
• レート制限超過
• サーバーエラー (5xxレスポンス)
• リクエストタイムアウト
• 入力検証エラー

エラー応答の形式

すべてのエラー応答には以下が含まれます。

• error: 人間が読めるエラーメッセージ
• timestamp: エラーが発生したISOタイムスタンプ
• package: エラーの原因となったパッケージ名
• registry: エラーが発生したレジストリ

入力検証

サーバーはすべての入力を検証します。

• パッケージ名: 空でない500文字以下の文字列である必要があります。
• バージョン: 空でない100文字以下の文字列である必要があります。
• レジストリ: サポートされているレジストリのいずれかである必要があります。
• バッチサイズ: リクエストごとの最大パッケージ数は100個です。
• 必須パラメータ: すべての必須フィールドが存在する必要があります。

応答の期待値

単一パッケージ用ツール

• 成功: found: true とともに完全なパッケージ情報を返します。
• 見つからない: found: false とエラーメッセージを返します。
• ネットワーク問題: 説明付きのエラーメッセージを返します。
• 常に含まれる: timestamp, package, registry フィールドが含まれます。

複数パッケージ用ツール

• 成功: 個々のステータスを持つ結果の配列を返します。
• 部分的な成功: 一部のパッケージが成功し、他のパッケージが失敗する - それぞれ個別の結果が返されます。
• エラー分離: 失敗したパッケージは成功したパッケージに影響しません。
• バッチ処理: すべてのパッケージが並列に処理され、効率が向上します。
• 一貫した形式: 各結果は単一パッケージ用ツールと同じ構造に従います。

開発

プロジェクト構造

dependency-mcp/
├── src/
│   ├── index.js          # メインのMCPサーバー
│   └── packageChecker.js # パッケージレジストリハンドラー
├── test/
│   └── test.js          # 基本的なテスト
├── package.json
└── README.md

テストの実行

npm test

デバッグモード

npm run dev

📄 ライセンス

MIT