Package Version Check MCP

🚀 package-version-check-mcp

このMCPサーバーは、Python、NPM、Go、GitHub Actionsなど、さまざまなエコシステムで依存関係として使用するパッケージの最新の安定バージョンを返します。また、mise-en-placeツールを介して、python、node、dotnetなどの開発ランタイム、gradleなどの開発ツール、kubectlやterraformなどのさまざまなDevOpsツールを含む、ほぼ1000のツールの最新バージョンを検索することもサポートしています。

🚀 クイックスタート

AIコーディングエージェントが依存関係のバージョンを固定したファイルを生成する際、トレーニングが数週間または数ヶ月前に行われ、それ以来新しい依存関係のバージョンがリリースされているため、古いバージョンが挿入されます。開発者として、これらの古いバージョンを手動で修正するのは面倒です。このMCPはこの問題を解決します。Context7などのMCPと一緒に使用することで、AIエージェントが古いコードを生成するのを防ぐことができます。

✨ 主な機能

サポートされているエコシステム/ツール

• 開発者エコシステム
  • NPM - registry.npmjs.orgのNode.jsパッケージ
  • PyPI - PyPIのPythonパッケージ
  • NuGet - NuGetの.NETパッケージ
  • Maven / Gradle - Mavenリポジトリ（Maven Central、Google Mavenなど）のJava/Kotlin/Scalaパッケージ
  • Go - proxy.golang.orgのGoモジュール
  • PHP - Packagist（Composerで使用）のPHPパッケージ
  • Ruby - rubygems.orgのRubyジェム
  • Rust - crates.ioのRustクレート
  • Swift - GitHubリポジトリのSwiftパッケージ
  • Dart - pub.devのDartパッケージ
• DevOpsエコシステム
  • Docker - DockerレジストリのDockerコンテナイメージ
  • Helm - ChartMuseumリポジトリとOCIレジストリのHelmチャート
  • GitHub Actions - GitHub.comにホストされているアクション。現在のバージョン、入力と出力、および（オプションで）使用例付きのREADME全体を返します。
  • Terraform Providers と Modules - Terraform Registry、OpenTofu Registry、またはカスタムレジストリのプロバイダーとモジュール
  • kubectl、terraform、gradle、mavenなど、mise-en-placeでサポートされているさまざまなツール

📦 インストール

エージェントへのMCPの追加

このMCPをAIコーディングエージェントで利用できるようにするには、3つの方法があります。

オプション1: ホストされたサービスを使用する（最も簡単）

エージェントを無料のホストサービスに向けます。

https://package-version-check-mcp.onrender.com/mcp

（ストリーミング可能な）HTTPモードで。これは最も迅速な開始方法です。ただし、ホストサービスは基盤となるパッケージレジストリからのレート制限がある場合があります。

オプション2: uvxで実行する（ローカル使用）

uvxを使用してMCPサーバーをローカルで実行します。

uvx package-version-check-mcp --mode=stdio

これにより、PyPIから最新バージョンが自動的にインストールされて実行されます。

要件

• get_supported_toolsまたはget_latest_tool_versionsツールを呼び出す場合は、PATHにmiseバイナリが必要です。

オプションだが推奨：GitHub APIのレート制限を回避するために、GITHUB_PAT環境変数をGitHubの個人用アクセストークン（スコープ不要）に設定します。

オプション3: Dockerで実行する（ローカル使用）

事前にビルドされたDockerイメージを使用します。

docker run --pull=always --rm -i ghcr.io/mshekow/package-version-check-mcp:latest --mode=stdio

オプションだが推奨：GitHub APIのレート制限を回避するために、-e GITHUB_PAT=your_token_hereを使用してGITHUB_PAT環境変数を渡します。

キャッシュ設定

パフォーマンスを向上させ、パッケージレジストリへのAPI呼び出しを減らすために、キャッシュを有効にすることができます。

• PACKAGE_VERSION_CACHE_ENABLED：キャッシュを有効にするにはtrueに設定します（デフォルトは無効）。
• PACKAGE_VERSION_CACHE_TTL_SECONDS：キャッシュの有効期限（秒）（デフォルト: 3600 / 1時間）。
• PACKAGE_VERSION_CACHE_MAX_SIZE_MB：キャッシュの最大サイズ（MB）（デフォルト: 64）。

キャッシュはメモリ内のTTL（Time-To-Live）キャッシュです。MCPサーバーが再起動するとリセットされます。

エージェントの設定

MCPサーバーを追加したら、以下のことが必要です。

1. エージェントの設定でMCPツールを有効にします。利用可能なツールは以下に記載されています。
2. プロンプトでエージェントにMCPを使用するように促します。ほとんどのLLMは明示的な指示がないと、このMCPのツールを自動的に呼び出しません。次のような指示を含めます。
   • "MCPを使用して最新バージョンを取得する"
   • "MCPツールを使用して最新のパッケージバージョンを確認する"
   • "get_latest_package_versionsを使用して現在のバージョンを見つける"

このプロンプトを追加するのを忘れ、エージェントが古いバージョンのコードを生成した場合は、後でエージェントにバージョンを更新するように依頼することができます（例: "MCPを介して、最近追加した依存関係を最新バージョンに更新する"）。

利用可能なツール

get_latest_package_versions

さまざまなエコシステムからパッケージの最新バージョンを取得します。

入力

• packages：パッケージ仕様の配列。各項目には以下が含まれます。
  • ecosystem（必須）："npm"、"pypi"、"nuget"、"maven_gradle"、"go"、"php"、"rubygems"、"rust"、"swift"、"dart"、"docker"、"helm"、"terraform_provider"、または"terraform_module"のいずれか。
  • package_name（必須）：パッケージの名前。
    • npmの場合：パッケージ名（例: "express"）
    • pypiの場合：パッケージ名（例: "requests"）
    • nugetの場合：パッケージ名（例: "Newtonsoft.Json"）
    • maven_gradleの場合："[registry:]:"形式（例: "org.springframework:spring-core"）。レジストリが省略された場合、Maven Centralが想定されます。
    • goの場合：絶対モジュール識別子（例: "github.com/gin-gonic/gin"）
    • phpの場合："vendor/package"形式のパッケージ名（例: "monolog/monolog"、"laravel/framework"）
    • rubygemsの場合：ジェム名（例: "rails"、"devise"）
    • rustの場合：クレート名（例: "serde"、"tokio"）
    • swiftの場合：GitHub URL（例: "https://github.com/Alamofire/Alamofire.git" または "github.com/owner/repo.git"）。github.comのみがサポートされています。
    • dartの場合：pub.devのパッケージ名（例: "http"、"flutter"）
    • dockerの場合：レジストリとネームスペースを含む完全修飾イメージ名（例: "index.docker.io/library/busybox"）
    • helmの場合：ChartMuseum URL（"https://host/path/chart-name"）またはOCI参照（"oci://host/path/chart-name"）
    • terraform_providerの場合："[registry/]/"形式（例: "hashicorp/aws" または "registry.terraform.io/hashicorp/aws"）。レジストリが省略された場合、registry.terraform.ioが想定されます。registry.opentofu.orgなどの代替レジストリもサポートされています。
    • terraform_moduleの場合："[registry/]//"形式（例: "terraform-aws-modules/vpc/aws" または "registry.terraform.io/terraform-aws-modules/vpc/aws"）。レジストリが省略された場合、registry.terraform.ioが想定されます。registry.opentofu.orgなどの代替レジストリもサポートされています。
  • version_hint（オプション）：
    • dockerの場合：タグ互換性ヒント（例: "1.36-alpine"）。同じサフィックスパターンに一致する最新のタグを見つけます。省略された場合、最新のセマンティックバージョンタグが返されます。
    • helm（OCIのみ）：Dockerと同様のタグ互換性ヒント
    • npm/pypi/nuget/maven_gradle/go/php/rubygems/rust/swift/dart/helm（ChartMuseum）/terraform_provider/terraform_moduleの場合：現在は使用されていません。

出力

• result：成功した検索の配列。
  • ecosystem：パッケージのエコシステム（指定された通り）
  • package_name：パッケージ名（指定された通り）
  • latest_version：最新のバージョン番号（例: "1.2.4"）またはDockerタグ
  • digest（オプション）：利用可能な場合のパッケージダイジェスト/ハッシュ。Dockerの場合、これはマニフェストダイジェスト（sha256）です。
  • published_on（オプション）：利用可能な場合の公開日（Dockerには適用されません）
• lookup_errors：エラーの配列。
  • ecosystem：パッケージのエコシステム（指定された通り）
  • package_name：パッケージ名（指定された通り）
  • error：エラーの説明

get_github_action_versions_and_args

github.comにホストされているGitHub Actionsの最新バージョンとメタデータを取得します。

入力

• action_names（必須）："owner/repo"形式のアクション名の配列（例: ["actions/checkout", "docker/login-action"]）
• include_readme（オプション）：ブール値（デフォルト: false）。アクションのREADME.mdを使用説明とともに含めるかどうか。

出力

• result：成功した検索の配列。
  • name：アクション名（指定された通り）
  • latest_version：最新のGitタグ（例: "v3.2.4"）
  • metadata：action.ymlのメタデータをオブジェクトとして、以下のフィールドを含みます。
    • inputs：アクションの入力パラメーター
    • outputs：アクションの出力
    • runs：実行構成
  • readme（オプション）：include_readmeがtrueの場合のアクションのREADME内容
• lookup_errors：エラーの配列。
  • name：アクション名（指定された通り）
  • error：エラーの説明

get_supported_tools

get_latest_tool_versions MCPツールでサポートされているすべてのツール名のリストを返します。このツールは、miseレジストリをクエリして、miseで管理できるすべての利用可能なツール名を取得します。

入力

• パラメーター不要

出力

• ツールの短い名前の配列（例: ["1password", "act", "node", "python", ...]）

get_latest_tool_versions

mise-en-placeでサポートされている開発およびDevOpsツールの最新の安定バージョンを取得します。このツールは、PyPIやNPMなどの言語エコシステムに属さないツール用です。言語エコシステムのパッケージ（Terraformプロバイダーとモジュールを含む）には、代わりにget_latest_package_versionsを使用してください。

使用例

• gradleまたはmaven：gradle-wrapper.propertiesまたはmaven-wrapper.propertiesのdistributionUrlでGradleまたはMavenのバージョンを固定します。
  • 例: distributionUrl=https://services.gradle.org/distributions/gradle-8.5-bin.zip
  • 例: distributionUrl=https://repo.maven.apache.org/.../apache-maven-3.9.6-bin.zip
• terraform：version.tfまたはversions.tfなどのファイルでterraform.required_versionを固定します。
  • 例: terraform { required_version = "~> 1.6.0" }
• kubectlまたはazure：curlまたはwgetで呼び出すダウンロードURLでバージョンを固定します。例えば、Dockerfile内で。
  • 例: RUN curl -LO https://dl.k8s.io/release/v1.28.0/bin/linux/amd64/kubectl

利用可能なすべてのツールを表示するには、get_supported_toolsツールを使用してください。

入力

• tool_names（必須）：ツール名の配列（例: ["terraform", "gradle", "kubectl"]）

出力

• result：成功した検索の配列。
  • tool_name：ツール名（指定された通り）
  • latest_version：最新の安定バージョン番号（例: "1.6.5"）
• lookup_errors：エラーの配列。
  • tool_name：ツール名（指定された通り）
  • error：エラーの説明

なぜ別のMCPを構築するのか

このMCPは、「古い依存関係」の問題に取り組む最初のものではありません。しかし、他のMCPに比べていくつかの利点があると考えています。

• 他のMCPよりもはるかに広いエコシステムカバレッジを提供しています。
• 完全なテストカバレッジがあり、自動化された依存関係の更新（Renovateによる）と定期的な自動リリースビルドが行われます。これに対し、他のプロジェクトはしばしば雰囲気でコーディングされ、テストが不十分（またはなし）で、作者が遊んでいるだけですでに放棄されています。
• このMCPは、ローカルで実行するためのいくつかの代替手段（uvxまたはdocker）を提供しています。また、無料のホストサービスを利用することもできます（他のMCPにはない機能）。
• このMCPは、セキュリティを強化した最小限のDocker/OCIイメージを使用しています。Trivyなどのツールで生成したSBOMは正しいことが知られており、イメージはCosignで署名されています（MCPを自前でホストする場合に、その信頼性を検証できます）。

開発

前提条件

mise-en-place

MCPサーバーは、ツールのバージョンを検索するためにmise-en-placeパッケージに依存しています。インストール手順については、https://mise.jdx.dev/installing-mise.html を参照してください。

サーバーを手動で実行する（開発用）

MCPサーバーをローカルで開発またはテストする場合は、直接実行することができます。まず、Poetryでのパッケージ管理 -> セットアップ手順に従って、仮想環境を構成します。次に、

.poetry/bin/poetry run python -m package_version_check_mcp.main

または、.venvがアクティブな場合は、

python src/package_version_check_mcp/main.py

Poetryによるパッケージ管理

セットアップ

新しいマシンでは、Poetry用のvenv（<project-root>/.poetryパス）とプロジェクト自体用のvenv（<project-root>/.venvパス）を作成します。例えば、C:\Users\USER\AppData\Local\Programs\Python\Python312\python.exe -m venv <path>を使用します。この分離は、プロジェクトとPoetryの間の依存関係の競合を回避するために必要です。

Poetryのvenvのpipを使用して、pip install -r requirements-poetry.txtでPoetryをインストールします。

次に、poetry sync --all-extrasを実行しますが、venvがアクティブでないか、.venvのみがアクティブであることを確認してください。.poetryはアクティブにしないでください（そうしないと、Poetryは依存関係をそこにインストールしてしまいます。ただし、事前にpoetry config virtualenvs.in-project trueを実行した場合は除きます）。--all-extrasフラグは、pytestなどの開発依存関係をインストールするために必要です。

依存関係の更新

• 依存関係が外部から変更された場合、例えばRenovateがpyproject.tomlとpoetry.lockファイルを更新した場合、poetry sync --all-extrasを実行してローカル環境を更新します。これにより、.venvのvenvから不要な依存関係が削除されます。
• あなたがpyproject.tomlの依存関係を更新した場合、poetry update && poetry sync --all-extrasを実行してロックファイルを更新し、追加機能を含む更新された依存関係をインストールします。
• 推移的な依存関係のみを更新する場合（pyproject.tomlの依存関係はそのまま）、poetry update && poetry sync --all-extrasを実行してロックファイルを更新し、アクティブなvenvに更新をインストールします。

上記のpoetryコマンドを実行する際には、venvがアクティブでないか、.venvのvenvがアクティブであることを確認してください。