Learning about MCP

MCP について学ぶ

TODO：

• サンプリングを実装する https://modelcontextprotocol.io/docs/concepts/sampling

• ルートを実装する。

学んだこと

• トランスポート方式は 2 種類あります。

  • stdio 経由です。クライアントが使用するサーバーバイナリへのパスを指定する必要があります。

  • sse 経由です。サーバーのネットワークアドレスを指定する必要があります。

    • このトランスポート方式のほうが、より汎用的だと思います。サーバーをクライアントとは別にデプロイできます。

• サーバーに fastify を使いたかったのですが、既存の SDK では動作させられませんでした。

  • これは、Node だけを使ってこのようなサーバーを書く方法を学ぶ絶好の機会です。

• MCP に関連する中核的なプリミティブは次のとおりです。

  • リソース — PDF やデータベースのレコードなどのデータで、クライアントがユーザーのクエリに対する適切な応答を作成するために使用できます。

  • プロンプト — 「prompt to x」のフローで、テキストボックスの下に表示されることがある、あらかじめ定義されたプロンプトのようなものです。

  • ツール — LLM がユーザーに代わってアクションを実行できるようにします。ツールを呼び出し、その結果をクライアントに返すのはサーバーです。クライアントの役割は、その結果を LLM に渡すことです。

  • サンプリング — 正直なところ、まだ何なのかよく分かっていません。

  • ルート — サーバーの「境界」を定義します。たとえば、サーバーがファイルシステムを操作するツールを公開している場合、「ルート」に特定のディレクトリを含めることで、そのツールの対象をそのディレクトリだけに限定できます。

  • トランスポート — これについては上で説明しました。STDIO と SSE のトランスポートがあります。メッセージは JSON-RPC 2.0 形式で構成されます。

• SDK にエラーハンドリングが組み込まれている点がとても気に入っています。

  • サーバーの tool コールバック関数でエラーをスローすると、クライアント SDK が処理して、適切に応答してくれます。