ルーツ

MCPにおけるルートの理解

ルートとは、MCPにおいてサーバーが動作できる境界を定義する概念です。ルートは、クライアントがサーバーに対して、関連するリソースとその場所を通知する方法を提供します。

ルートとは？

ルートとは、クライアントがサーバーに対して注目すべき場所として提案するURIです。クライアントがサーバーに接続する際、サーバーが扱うべきルートを宣言します。主にファイルシステムのパスに使用されますが、ルートはHTTP URLを含む有効なURIであれば何でも構いません。

例えば、ルートは以下のようになります。

file:///home/user/projects/myapp
https://api.example.com/v1

ルートを使用する理由？

ルートは、いくつかの重要な目的を果たします。

ガイダンス: サーバーに関連するリソースと場所を通知します。

明確性: ルートは、ワークスペースの一部であるリソースを明確にします。

組織化: 複数のルートを使用することで、異なるリソースを同時に扱うことができます。

ルートの仕組み

クライアントがルートをサポートする場合：

接続時に roots capability を宣言します。

サーバーに提案するルートのリストを提供します。

ルートが変更された場合にサーバーに通知します（サポートされている場合）。

ルートは情報提供であり、厳密に強制するものではありませんが、サーバーは以下を行う必要があります。

提供されたルートを尊重します。

ルートURIを使用してリソースを特定し、アクセスします。

ルートの境界内での操作を優先します。

一般的なユースケース

ルートは、一般的に以下を定義するために使用されます。

プロジェクトディレクトリ

リポジトリの場所

API endpoints

コンフィギュレーションの場所

リソースの境界

ベストプラクティス

ルートを扱う際には：

必要なリソースのみを提案します。

ルートに明確で説明的な名前を使用します。

ルートのアクセシビリティを監視します。

ルートの変更を適切に処理します。

例

以下は、典型的なMCPクライアントがルートを公開する方法です。

{
  "roots": [
    {
      "uri": "file:///home/user/projects/frontend",
      "name": "Frontend Repository"
    },
    {
      "uri": "https://api.example.com/v1",
      "name": "API Endpoint"
    }
  ]
}

この構成は、サーバーがローカルリポジトリとAPI endpointの両方に焦点を当て、それらを論理的に分離することを提案しています。

ルートとは？#

ルートを使用する理由？#

ルートの仕組み#

一般的なユースケース#

ベストプラクティス#

例#

ルートとは？

ルートを使用する理由？

ルートの仕組み

一般的なユースケース

ベストプラクティス

例