modelcontextprotocol/quickstart-resources

解決する問題

Model Context Protocol (MCP) は、Claude のような AI アシスタントが外部ツールを呼び出せるようにする標準です。このリポジトリは、5つのプログラミング言語で最小限の動作するサーバーとクライアントの例を提供し、開発者が詳細を推測することなく MCP 対応アプリケーションの構築方法を学べるようにします。

仕組み

例は2種類あります。

• 天気サーバー（MCP サーバー）: 米国国立気象局 API をバックエンドとする get_forecast と get_alerts の2つのツールを公開するシンプルなサーバー。すべてのサーバーは stdio で通信し、同じ2つのツールを公開します。
• チャットボット（MCP クライアント）: サーバーを起動し、そのツールを一覧表示し、Claude がそれらのツールを呼び出せる対話型チャットループを実行する LLM 搭載チャットボット。クライアントには ANTHROPIC_API_KEY が必要ですが、なくても接続してサーバーのツールを一覧表示できるため、資格情報なしで MCP 配線を確認できます。

各例は独自のディレクトリにあり、前提条件、セットアップ、実行方法を説明する README が含まれています。言語をまたいで組み合わせることもできます。たとえば、Python クライアントで TypeScript サーバーを駆動できます。tests ディレクトリには CI で実行されるスモークテストが含まれており、すべてのサーバーが起動して MCP リクエストに応答し、すべてのクライアントがモックサーバーに接続してツールを一覧表示できることを検証します。

対象読者

これは、Model Context Protocol を学習している開発者、既に使用している言語での実用的な例を見たい開発者、または独自の MCP サーバーとクライアントを構築するための最小限で十分にテストされた出発点を探している開発者向けです。例は意図的に最小限に保たれています。プロトコルを教えるために存在し、本番サービスではありません。

ハイライト

• 5言語でのサーバーとクライアントの例: Python、TypeScript、Go、Rust、Ruby
• すべてのサーバーが同じ2つの天気ツールを公開するため、実装を直接比較できます
• クライアントは Claude がサーバーのツールを呼び出せる対話型チャットボットです
• 言語間の相互運用性 — クライアントとサーバーを組み合わせて使用できます
• すべてのプルリクエストで自動スモークテストが実行され、例の信頼性を維持します
• セットアップと実行手順を含む明確な例ごとの README