A Simple MCP Server And Client

🚀 シンプルなMCPサーバーとクライアント

このプロジェクトは、天気情報を公開し、アクセスする方法を示す、シンプルなModel Context Protocol (MCP) のサーバーとクライアントの実装です。

🚀 クイックスタート

このサンプルを実行するには、以下の手順に従ってください。

クライアントの起動

node client.js

クライアントを起動すると、自動的にサーバーが子プロセスとして起動されます。クライアントはサーバーに接続し、すべてのサンプル操作を実行します。

サーバーの独立起動

node server.js

✨ 主な機能

サーバー

サーバーは server.js ファイルで実装されており、以下の機能を提供します。

• リソース

  • city://NewYork：ニューヨーク市の基本情報
  • city://London：ロンドン市の基本情報
  • city://Tokyo：東京市の基本情報

• ツール

  • get-weather：特定の都市の天気予報を取得します。都市名と日数をパラメータとしてサポートします。

• ヒント

  • weather-advice：天気状況に基づいて旅行のアドバイスを取得します。

クライアント

クライアントは client.js ファイルで実装されており、以下のことを示しています。

• MCPサーバーに接続する
• 利用可能なリソースをリストする
• 特定の都市のリソースを読み取る
• 天気予報ツールを呼び出す
• 天気のヒント情報を取得する

📚 ドキュメント

JSON-RPC通信

この実装では、クライアントとサーバー間の通信にJSON-RPC 2.0を使用しています。使用されるJSON-RPCの主要な概念は以下の通りです。

• メソッド：resources/list、resources/read、tools/call、prompts/get などの標準メソッド名
• パラメータ：メソッド呼び出しとともに送信される入力データ
• リクエスト識別子：レスポンスとのマッチングに使用される一意の識別子
• 結果/エラー：構造化されたレスポンスデータまたはエラー情報

MCP SDKは多くの部分を抽象化していますが、プロトコルを理解することはデバッグやカスタマイズに役立ちます。コンソール出力を見ることで、元のJSON-RPCメッセージを確認できます。

伝送メカニズム

このサンプルでは、クライアントとサーバー間の伝送メカニズムとしてstdio（標準入出力）を使用しています。クライアントが起動すると、サーバーを子プロセスとして生成し、stdin/stdoutストリームを介して通信します。

クライアントとサーバー間で交換されるメッセージを表示するためのカスタムログ記録伝送が実装されています。これらのメッセージは人間が読みやすい形式でコンソールに記録され、プロトコルの理解に非常に役立ちます。

🔧 トラブルシューティング

リソースまたはヒントのリクエストがタイムアウトする問題が発生した場合は、サーバーの実装を確認してください。サンプルでは、現在のSDKバージョンの制限を解決するために直接メッセージ処理を実装しています。