MCP Registry Navigator

公式の Model Context Protocol Registry から公開されているサーバーを発見・比較・監査するための、読み取り専用のMCPサーバーです。

公式の Model Context Protocol Registry に公開されているサーバーを発見・比較・監査するための、読み取り専用のMCPサーバーです。

概要

MCP Registry Navigator は、エージェントや開発者が MCP サーバーをインストールまたは公開する前に、実用的な疑問に答えられるよう支援します。

• どの MCP サーバーがタスクに最も適しているのか？

• どのパッケージ・レジストリ、トランスポート、インストール命令を使用しているのか？

• server.json ファイルはレジストリ公開の準備ができているのか？

• PyPI・npm・OCI のMCPサーバーを公開する前に従うべきチェックリストは何か？

このサーバーはユーザーのファイルを編集しません。構造化されたレポート、生成された構成スニペット、レビュー用チェックリストを返し、呼び出し側がこれらを確認して手動で適用できます。

Related MCP server: MCP Registry Server

概要

MCP Registry Navigator は、エージェントと開発者が MCP サーバーをインストールまたは公開する前に適切な判断を下せるよう支援します。

• 与えられたタスクにどの MCP サーバーが最適か？

• どのパッケージ・レジストリ・トランスポート・インストール命令を使っているのか？

• server.json はレジストリ公開の準備ができているか？

• PyPI、npm、OCI 経由で MCP サーバーを公開する前に、どのチェックリストを従うべきか？

このサーバーはユーザーのファイルを一切変更しません。構造化されたレポート、生成された構成スニペット、チェックリストを返し、呼び出し側が確認して手動で適用できるようにしています。

機能

• 最新のサーバーを https://registry.modelcontextprotocol.io から検索する。

• レジストリ名とバージョンで特定のサーバーを取得する。

• サーバーのパッケージ種別、トランスポート、識別を比較する。

• 公開前に server.json のメタデータを検証する。

• PyPI・npm・OCI パッケージ向けの MCP クライアントのインストール・スニペットを生成する。

• PyPI・npm・OCI のレジストリ公開フローのためのバブリケーション・チェックリストを用意する。

• 公式 Python SDK v2 を通して MCP のツール・リソース・プロンプトを提可する。

• ローカルの TTL JSON キャッシュと決定的なテスト・フィクスチャを利用する。

MCP のプリミティブ

ツール

• search_servers

• get_server

• compare_servers

• validate_server_json

• generate_install_config

• prepare_publish_checklist

リソース

• registry://servers/{name}

• registry://latest

• registry://cache/status

プロンプト

• choose_mcp_server

• audit_mcp_metadata

• prepare_mcp_release

必説の要件

• Python 公式して3.12 それ以降。

• [uv] (https://docs.astral.sh/uv/) をローカルの Python 依存関係管理に使用する。

• MCP Inspector を使用する場合のみ Node.js 22.19.0 それ以降。

インストール

ローカルのチェックアウートから：

uv sync
uv run mcp-registry-navigator --version

ローカルのクローンから：

uv sync
uv run mcp-registry-navigator --version

使と方

ローカルMCPクライアントのデフォルト・トランスポートである stdio で実行する：

uv run mcp-registry-navigator

ローカル MCPの場合クライアントのデフォルト・トランスポートである stdio でサーバーを起動する：

uv run mcp-registry-navigator

ローカルテスト用に StreamableHTTP として実行する：

uv run mcp-registry-navigator --transport streamable-http --host 127.0.0.1 --port 8000

ローカルテスト用に Streamable HTTP としてサーバーを起動する：

uv run mcp-registry-navigator --transport streamable-http --host 127.0.0.1 --port 8000

MCP Inspector を実行する：

npm install
npm run inspect

MCP Inspector を起動する：

npm install
npm run inspect

このリポジトリには .node-version と package.json が含まてれており、ローカル検証では、一部の mcp dev 環境にある旧バージョンの v1 ラウンをまれに @modelcontextprotocol/inspector の v2 を利用する。

クライアント構成例

ローカル・チェックアウトの場合：

{
  "mcpServers": {
    "mcp-registry-navigator": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-registry-navigator",
        "run",
        "mcp-registry-navigator"
      ]
    }
  }
}

PyPI に公開した後は、コマンドをより簡略にできます：

{
  "mcpServers": {
    "mcp-registry-navigator": {
      "command": "uvx",
      "args": ["mcp-registry-navigator"]
    }
  }
}

環境開発

uv run python -m pytest -q
uv run ruff check .
uv run mypy
uv build
npm run inspect

テスト・スイートは、決定的でオフラインの対象範囲を得るため、レジストリのダミー応答を使用します。MCPのインテグレーション・テストは SDK のイン・メモリ・クライアントを使用するため、ポートを開きません。

テスト・スイートはダミーのレジストリ応答を使い、決定的でオフラインのカバー率を実現します。MCP のインテグレーション・テストは SDK のイン・メモリ・クライアントを利用し、ポートは開きません。

キャッシュ

デフォルトのキャッシュ・ファイルは次のとおりです：

~/.cache/mcp-registry-navigator/registry-cache.json

キャッシュ・ルートを変更するには XDG_CACHE_HOME を設定します。ディスク書込みを避けたい場合は、テストや組み込みコード、いずれる場合でも NullCache を使用します。

デフォルトのキャッシュ・ファイルは次のとおりです：

~/.cache/mcp-registry-navigator/registry-cache.json

キャッシュのルートを変えるには XDG_CACHE_HOME を設定します。ディスクへの書込みを行いたくない場合、テストまたは組込みコードでは NullCache を使用してください。

リポジトリのステータス

このプロジェクトは現在アルファ・ソフトウェアです。続けてMCPにエジストリと Python SDK が進化するにつれて、API とこのツールが生成する推奬内容は変更くなことがあります。

このプロジェクトは現在アルファ段階にあります。MCP レジストリと Python SDK が進か続くに伴い、API と生成される推奨事項は変わる可能性があります。

リリースノート

PyPI に公開する前に、実際の GitHub のリポジトリ URL とイッシュートラッカーを pyproject.toml の [project.urls] りに追加してください。

PyPI に公開する前に、実際の GitHub レポジトリの URL とイッシュートラッカーへのリンクを pyproject.toml 内の [project.urls] に追加してください。

その後、このサーバーを公式 MCP Registry に PyPI パッケージとして公開する場合は、レジストリの検証マーカーをこの README に追加してください：

<!-- mcp-name: io.github.YOUR_GITHUB_USERNAME/mcp-registry-navigator -->

このサーバーを公式 MCP Registry に PyPI パッケージとして公開する場合は、上記の検証マーカーをこの README に追加してください。

ライセンス

MIT。 LICENSE を参照してください。