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つは組み合わせて使うこともでき、能力は初期化時に申告する
関連記事
- MCPサーバーに関して①:全体像と基本概念 — ホスト/クライアント/サーバーの3つの役割と、MCPの全体像を解説
- MCPサーバーに関して②:通信の仕組み — JSON-RPC 2.0のメッセージ形式と、初期化・ライフサイクル、2つのトランスポートを解説
参考リンク
- Tools - Model Context Protocol — Toolsの仕組み、定義、エラー処理、セキュリティの公式解説
- Resources - Model Context Protocol — Resourcesの仕組み、URIスキーム、テンプレート、購読の公式解説
- Prompts - Model Context Protocol — Promptsの仕組み、引数、メッセージデータの公式解説
用語集
- 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の典型的な出し方