0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCPサーバーに関して③:サーバーが提供する3つの機能

0
Posted at

MCPサーバーに関して③:サーバーが提供する3つの機能

MCPサーバーは、クライアント(=LLMアプリ)に何を渡せるのでしょうか。答えは3つだけです。Tools(ツール)・Resources(リソース)・Prompts(プロンプト)。この3つは「誰が使うタイミングを決めるか」で性格がはっきり分かれます。第3回は、この違いを軸に整理します。

この記事で分かること

  • サーバーが提供する3つの機能の違い
  • それぞれ「誰が主導権を持つか」という整理の軸
  • 3つの機能の使い分けの目安

全体像:3つの機能は「主導権」で分かれる

MCPサーバーが提供できる機能は、Tools・Resources・Promptsの3種類だけです。どれもクライアントがサーバーに問い合わせる形は同じですが、使うタイミングを誰が決めるかが違います。

機能 主導権 一言で言うと 主なメソッド
Tools モデル(LLM) LLMが「実行する」機能 tools/list / tools/call
Resources アプリケーション LLMに「読ませる」データ resources/list / resources/read
Prompts ユーザー ユーザーが「選ぶ」定型の指示 prompts/list / prompts/get

この違いを押さえると、サーバー設計で「どの機能で作るべきか」の判断がぶれにくくなります。

Tools:モデルが「実行する」機能

Toolsは、LLMが外部システムとやり取りする機能です。データベースの検索、APIの呼び出し、計算などがここにあたります。ポイントは、呼ぶかどうかをLLM自身が判断することです。会話の文脈を見て、必要だと思えば呼び、不要なら呼びません。

ツール1つは、次の情報で定義されます。

項目 意味
name ツールの一意な名前(例:search_faq)
description 何をするツールかの説明。LLMはこれを読んで使うかどうかを判断する
inputSchema 引数の形を定めたJSON Schema。型や必須項目をここで決める
outputSchema 任意。返す結果の構造を定める

たとえば、社内のFAQを検索するツールなら、引数はこんな形になります。

{
  "name": "search_faq",
  "description": "社内のFAQから質問に関連する回答を検索する",
  "inputSchema": {
    "type": "object",
    "properties": {
      "question": { "type": "string", "description": "検索したい質問文" },
      "max_results": { "type": "integer", "description": "返す件数" }
    },
    "required": ["question"]
  }
}

クライアントはまずtools/listで一覧を取得し、LLMが「使いたい」と判断したらtools/callで呼び出します。結果はテキストなどの「非構造化コンテンツ」か、スキーマに沿ったJSONの「構造化コンテンツ」で返ります。

エラーには2種類あります。プロトコルエラーは「存在しないツールを呼んだ」などリクエスト自体の問題で、通常のJSON-RPCエラーとして返ります。ツール実行エラーは「APIが失敗した」など実行中の問題で、結果にisError: trueを付けて返ります。後者はLLMが内容を読んで修正し、再試行できます。

Toolsは副作用(外部の状態を変えること)を持つ唯一の機能です。ファイルの書き込みやデータの更新ができるのもToolsだけです。その分、サーバー側は入力の検証・アクセス制御・実行回数の制限が必須で、クライアント側は機密性の高い操作では実行前にユーザーへ確認を促すことが求められています。

Resources:アプリがLLMに「読ませる」データ

Resourcesは、LLMに文脈として渡すためのデータです。ファイル、データベースのスキーマ、アプリ固有の情報などがここにあたります。Toolsと違い、何を渡すかはアプリケーション(ホスト)が決めます。たとえばエディタが開いているファイルの一覧を出して、ユーザーが選んだものをLLMに読ませる、という形です。LLMが勝手に読みに行くことはありません。

リソースはURIで一意に識別されます。resources/listで一覧を取得し、resources/readで中身を読み取ります。URIのスキームには次のようなものがあります。

スキーム 用途
file:// ファイルシステムのように扱うリソース。実際のファイルでなくてもよい
https:// Web上のリソース。クライアントが直接取得できる場合に使う
git:// Gitリポジトリとの連携
独自スキーム アプリ固有の識別子(例:app://)も定義できる

中身はテキストかバイナリ(base64で送る)のどちらかです。リソースには使い方のヒントになるアノテーションを付けられます。

アノテーション 意味
audience 想定する読み手。userかassistant(または両方)
priority 0.0〜1.0の重要度。1に近いほど必須に近い
lastModified 最終更新日時(ISO 8601形式)

また、決まったURIだけでなく、リソーステンプレートでパラメータ付きのURIを公開することもできます。たとえばfile:///docs/{name}.mdのように、名前を指定して読み取るリソースを1つの定義で表せます。subscribeに対応したサーバーでは、リソースの変更を購読して更新通知を受け取ることもできます。

大事なのは、Resourcesは**読み取り専用の「文脈」**で、データを変えることはできません。「知ってほしい情報」はResources、「やらせたい操作」はTools、と分けると覚えやすいでしょう。

Prompts:ユーザーが「選ぶ」定型の指示

Promptsは、サーバーが用意したプロンプトのテンプレートです。LLMへの指示文を定型化して、ユーザーが選んで使えるようにしたものです。ここではユーザーが主導権を持ちます。典型的には、クライアントのUIにスラッシュコマンドのような形で表示され、ユーザーが明示的に選んで実行します。

プロンプトの定義はシンプルです。name・descriptionに加えて、テンプレートをカスタマイズする**引数(arguments)**を持てます。たとえば、コードレビュー用のプロンプトなら次のような形です。

{
  "name": "review_code",
  "description": "渡されたコードをレビューして改善点を指摘する",
  "arguments": [
    { "name": "language", "description": "コードの言語", "required": true },
    { "name": "focus", "description": "重点的に見てほしい観点", "required": false }
  ]
}

クライアントはprompts/listで一覧を取得し、ユーザーが選んだらprompts/getに引数を渡して内容を取得します。返ってくるのはメッセージのリストで、各メッセージにはrole(userかassistant)と内容が入ります。テキストが中心ですが、画像・音声やリソースのリンク・埋め込みも含められます。

内容を作るのはサーバー側で、ユーザーが決めるのは「いつ・どのプロンプトを使うか」だけです。よく使う指示をテンプレート化すれば、毎回長い指示を打つ手間が省け、チームで同じ品質の指示を使い回せます。

使い分け:迷ったらこの流れで選ぶ

3つの機能の使い分けは、こう考えるとシンプルです。

実際には3つを組み合わせることもよくあります。たとえば、コードレビューのPromptsがリソースへのリンク(レビュー対象のファイル)を含み、LLMがレビュー中にToolsで関連ファイルを追加で読む、という流れです。Promptsが入口になり、Resourcesが文脈を補い、Toolsが操作を担います。

なお、サーバーは3つすべてを持つ必要はありません。提供する機能は初期化時の**能力(capabilities)**で申告し、クライアントは申告されたものだけを使います。まずは1つから小さく始めるのが現実的です。次回以降、④で既存サーバーの導入、⑤⑥⑦で自作と各機能の実装を掘り下げます。

まとめ

  • MCPサーバーが提供する機能はTools・Resources・Promptsの3つだけ
  • Toolsはモデル主導でLLMが実行を判断する。副作用を持つ唯一の機能で、inputSchemaで引数を定義する
  • Resourcesはアプリ主導で、URIで識別される読み取り専用の文脈データ。テンプレートや購読にも対応する
  • Promptsはユーザー主導で、引数付きの定型指示テンプレート。スラッシュコマンドのように選んで使う
  • 迷ったら「操作させたい→Tools」「読ませたい→Resources」「定型指示を使い回したい→Prompts」で選ぶ
  • 3つは組み合わせて使うこともでき、能力は初期化時に申告する

関連記事

参考リンク

用語集

  • Tools:MCPサーバーがLLMに提供する「実行できる機能」。LLMが使うかどうかを判断する
  • Resources:MCPサーバーが提供する「読ませるためのデータ」。URIで識別され、読み取り専用
  • Prompts:MCPサーバーが提供する「プロンプトのテンプレート」。ユーザーが選んで使う定型の指示文
  • 主導権:その機能を「いつ・どう使うか」を決める主体。Toolsはモデル、Resourcesはアプリケーション、Promptsはユーザー
  • JSON Schema:JSONデータの形(型・必須項目など)を宣言するための仕様。ツールの入力や出力の定義に使う
  • inputSchema:ツールが受け取る引数の形を定めたJSON Schema
  • outputSchema:ツールが返す結果の構造を定めたJSON Schema(任意)
  • URI:リソースを一意に識別するための文字列。file://やhttps://などのスキームを持つ
  • リソーステンプレート:パラメータ付きのURIでリソースを公開する仕組み。{name}のように引数を埋め込める
  • アノテーション:リソースの使い方のヒントになる付加情報。読み手(audience)・重要度(priority)・最終更新日時など
  • 副作用:外部の状態を変えること。ファイルの書き込みやデータの更新などが該当する
  • プロトコルエラー:リクエスト自体の問題を示すJSON-RPCのエラー。存在しないツールの呼び出しなどが該当する
  • ツール実行エラー:ツール実行中の問題を示すエラー。結果にisError: trueを付けて返し、LLMが修正して再試行できる
  • 能力(capabilities):初期化時に申告する、対応している機能の一覧。合意したものだけが使われる
  • スラッシュコマンド:チャットUIなどで「/」から始めて呼び出す定型コマンド。Promptsの典型的な出し方
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?