MCPレジストリ

MCP Marketplaceで入手

MCPレジストリは、MCPクライアントにMCPサーバーのリストを提供する、MCPサーバーのためのアプリストアのようなものです。

📤 MCPサーバーを公開する | ⚡️ ライブAPIドキュメント | 👀 エコシステムのビジョン | 📖 完全なドキュメント

開発状況

2025-10-24 更新: レジストリAPIは APIフリーズ (v0.1) に入りました 🎉。今後1ヶ月以上、APIは破壊的変更なしで安定した状態を維持し、インテグレーターが安心してサポートを実装できるようにします。このフリーズはv0.1に適用され、v0の開発は継続されます。この期間を利用して、実際の統合環境でAPIを検証し、一般公開に向けたv1の策定に役立てるフィードバックを収集します。貢献してくださった皆様、そして忍耐強くお待ちいただいた皆様に感謝いたします。皆様の関与がここまで到達するための鍵となりました！

2025-09-08 更新: レジストリがプレビュー版として公開されました 🎉 (発表ブログ記事)。システムは以前より安定しましたが、まだプレビューリリースであり、破壊的変更やデータのリセットが発生する可能性があります。一般公開（GA）リリースは後日行われる予定です。GitHubディスカッションまたは #registry-dev Discord (参加詳細はこちら) でフィードバックをお待ちしております。

現在の主要メンテナー:

Adam Jones (Anthropic) @domdomegg
Tadas Antanavicius (PulseMCP) @tadasant
Toby Padilla (GitHub) @toby
Radoslav (Rado) Dimitrov (Stacklok) @rdimitrov

貢献について

コラボレーションには複数のチャネルを使用しています - modelcontextprotocol.io/community/communication を参照してください。

多くの場合（常にではありませんが）、アイデアは以下のパイプラインを通じて流れます:

Discord - リアルタイムのコミュニティディスカッション
Discussions - 製品/技術要件の提案と議論
Issues - 範囲が明確な技術作業の追跡
Pull Requests - イシューに対する作業の貢献

クイックスタート:

前提条件

Docker
Go 1.24.x
ko - Go用コンテナイメージビルダー (インストール手順)
golangci-lint v2.4.0

サーバーの実行

# Start full development environment
make dev-compose

これにより、PostgreSQLを使用して localhost:8080 でレジストリが起動します。データベースはエフェメラルストレージを使用し、コンテナを再起動するたびにリセットされるため、開発とテストのためのクリーンな状態が保証されます。

注: レジストリは ko を使用してコンテナイメージをビルドします。make dev-compose コマンドは、サービスを開始する前に、koを使用してレジストリイメージを自動的にビルドし、ローカルのDockerデーモンにロードします。

デフォルトでは、レジストリは起動を高速に保つために、サーバーのフィルタリングされたサブセットを使用して本番APIからシード（初期データ読み込み）を行います。これにより、ローカル環境が本番環境の動作を反映し、すべてのシードデータが検証を通過することが保証されます。オフライン開発の場合は、MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose を使用して、検証なしでファイルからシードを行うことができます。

セットアップは docker-compose.yml の環境変数で構成できます - 参考として .env.example を参照してください。

ビルド済みのDockerイメージは、GitHub Container Registryに自動的に公開されます:

# Run latest stable release
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# Run latest from main branch (continuous deployment)
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# Run specific release version
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# Run development build from main branch
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

利用可能なタグ:

リリース: latest, v1.0.0, v1.1.0 など
継続的: main (最新のメインブランチビルド)
開発: main-<date>-<sha> (特定のコミットビルド)

サーバーの公開

サーバーを公開するために、シンプルなCLIを作成しました。以下のように使用できます:

# Build the latest CLI
make publisher

# Use it!
./bin/mcp-publisher --help

詳細はパブリッシャーガイドを参照してください。

その他のコマンド

# Run lint, unit tests and integration tests
make check

開発に役立つコマンドが他にもいくつかあります。詳細については make help を実行するか、Makefile を確認してください。

アーキテクチャ

プロジェクト構造

├── cmd/                     # Application entry points
│   └── publisher/           # Server publishing tool
├── data/                    # Seed data
├── deploy/                  # Deployment configuration (Pulumi)
├── docs/                    # Documentation
├── internal/                # Private application code
│   ├── api/                 # HTTP handlers and routing
│   ├── auth/                # Authentication (GitHub OAuth, JWT, namespace blocking)
│   ├── config/              # Configuration management
│   ├── database/            # Data persistence (PostgreSQL)
│   ├── service/             # Business logic
│   ├── telemetry/           # Metrics and monitoring
│   └── validators/          # Input validation
├── pkg/                     # Public packages
│   ├── api/                 # API types and structures
│   │   └── v0/              # Version 0 API types
│   └── model/               # Data models for server.json
├── scripts/                 # Development and testing scripts
├── tests/                   # Integration tests
└── tools/                   # CLI tools and utilities
    └── validate-*.sh        # Schema validation tools

認証

公開は複数の認証方法をサポートしています:

GitHub OAuth - GitHubにログインして公開する場合
GitHub OIDC - GitHub Actionsから公開する場合
DNS検証 - ドメインとそのサブドメインの所有権を証明する場合
HTTP検証 - ドメインの所有権を証明する場合

レジストリは公開時に名前空間の所有権を検証します。例: 公開するには...:

io.github.domdomegg/my-cool-mcp を公開するには、GitHubに domdomegg としてログインするか、domdomeggのリポジトリでGitHub Actionを実行している必要があります
me.adamjones/my-cool-mcp を公開するには、DNSまたはHTTPチャレンジを通じて adamjones.me の所有権を証明する必要があります

コミュニティプロジェクト

コミュニティプロジェクトをチェックして、コミュニティによって作成された注目すべきレジストリ関連の成果物を探索してください。

その他のドキュメント

ここに質問の答えがない場合は、ドキュメントを参照して詳細を確認してください！

meridian-edge-mcp