Avalanche MCP Vscode

🚀 MCP Registry

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

| ⚡️ ライブAPIドキュメント | | 📖 完全なドキュメント

🚀 クイックスタート

開発状況

2025年10月24日更新: レジストリAPIは APIフリーズ (v0.1) に入りました 🎉。今後1か月以上、APIは安定し、破壊的な変更は行われません。これにより、インテグレーターは自信を持ってサポートを実装できます。このフリーズはv0.1に適用され、v0の開発は続行されます。この期間を利用して、実際のインテグレーションでAPIを検証し、フィードバックを収集し、一般公開用のv1を形作ります。皆様の貢献と忍耐に感謝します。皆様の関与がここまで到達するための重要な要素でした！

2025年9月8日更新: レジストリがプレビュー版として公開されました 🎉 (アナウンスブログ記事)。システムは現在より安定していますが、これはまだプレビューリリースであり、破壊的な変更やデータのリセットが発生する可能性があります。その後、一般公開 (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

サーバーの実行

# 完全な開発環境を起動
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 run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# メインブランチの最新版を実行 (継続的デプロイメント)
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# 特定のリリースバージョンを実行
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# メインブランチの開発ビルドを実行
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

サーバーの公開

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

# 最新のCLIをビルド
make publisher

# 使用する！
./bin/mcp-publisher --help

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

その他のコマンド

# リント、単体テスト、統合テストを実行
make check

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

🔧 技術詳細

プロジェクト構造

├── cmd/                     # アプリケーションのエントリポイント
│   └── publisher/           # サーバー公開ツール
├── data/                    # シードデータ
├── deploy/                  # デプロイメント構成 (Pulumi)
├── docs/                    # ドキュメント
├── internal/                # 非公開のアプリケーションコード
│   ├── api/                 # HTTPハンドラーとルーティング
│   ├── auth/                # 認証 (GitHub OAuth、JWT、ネームスペースブロッキング)
│   ├── config/              # 設定管理
│   ├── database/            # データ永続化 (PostgreSQL)
│   ├── service/             # ビジネスロジック
│   ├── telemetry/           # メトリクスとモニタリング
│   └── validators/          # 入力検証
├── pkg/                     # 公開パッケージ
│   ├── api/                 # APIの型と構造
│   │   └── v0/              # バージョン0のAPI型
│   └── model/               # server.jsonのデータモデル
├── scripts/                 # 開発とテスト用のスクリプト
├── tests/                   # 統合テスト
└── tools/                   # CLIツールとユーティリティ
    └── validate-*.sh        # スキーマ検証ツール

認証

公開には複数の認証方法がサポートされています:

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

レジストリは、公開時にネームスペースの所有権を検証します。例えば、以下のように公開する場合:

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

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

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

📚 ドキュメント

ここで質問が解決しない場合は、ドキュメント を参照してください！