MCP Server Learning

🚀 学習 MCP プロトコル

このプロジェクトは、MCP プロトコルの学習を目的としており、MCP プロトコルの実装や関連概念の理解に役立ちます。

🚀 クイックスタート

待办事項

• サンプリング方法を実装する https://modelcontextprotocol.io/docs/concepts/sampling
• ルートディレクトリを実装する

学習要点

• 2種類の伝送方式が存在します：
  • stdio を通じた伝送。この場合、クライアントが使用するサーバーのバイナリファイルのパスを提供する必要があります。
  • sse を通じた伝送。この場合、サーバーのネットワークアドレスを提供する必要があります。
    • この伝送方式はより汎用的です。サーバーをクライアントから独立してデプロイすることができます。
• fastify を使ってサーバーを構築したいですが、既存の SDK と連携できませんでした。
  • これは Node.js だけでサーバーを書く方法を学ぶ良い機会です！
• MCP に関連する核心的なプリミティブ は以下の通りです：
  • リソース – ユーザーのクエリに基づいて適切な応答を生成するために使用されるデータ（PDF、データベースレコードなど）と考えることができます。
  • プロンプト – 「プロンプトから x」のプロセスで、テキストボックスの下に定義されるプロンプト文と考えることができます。
  • ツール – LLM がユーザーを代表して操作を実行できるようにするものです。サーバーはツールを呼び出し、結果を使用してクライアントに応答する責任があります。クライアントの役割は、これらの結果を LLM に渡すことです。
  • サンプリング – これについてはまだあまり理解していません。
  • ルートディレクトリ – サーバーの「境界」を定義します。たとえば、サーバーがファイルシステムとやり取りするツールを公開している場合、特定のディレクトリを「ルートディレクトリ」に含めることで、そのツールをそのディレクトリ内に「制限」することができます。
  • 伝送方式 – 上で説明した通り、STDIO と SSE の2種類があります。メッセージ形式は JSON - RPC 2.0 プロトコルに基づいています。
• SDK にエラーハンドリング機能が組み込まれているのが大好きです。
  • サーバーの tool コールバック関数でエラーを投げると、クライアント SDK がそのエラーを処理し、適切な応答を返します。