AIエージェントとシステムをつなぐMCP入門（リソース編）

本ページは「AIエージェントとシステムをつなぐMCP入門」の続編です。
今回は、リソースについて説明します。

MCPのリソースは、AIモデルが回答を生成する際に参照するコンテキスト情報（ファイル、ガイド、仕様など）を提供する機能です。
ツールが「AIモデルの判断」で実行され、プロンプトが「ユーザーの意思」で選択されるのに対し、リソースは「アプリケーション主導（Application-driven）」でその組み込みを決定します。

本記事で掲載しているコードはこちらで公開しています。

• npm@11.11.1
• node@22.22.0
• typescript@6.0.3
• @modelcontextprotocol/sdk@1.29.0
• zod@4.3.6

• 開発ガイドの共有: コーディング規約や設計方針をリソース化して、AI生成時の前提情報として渡します
• 仕様断片の参照: API仕様、エラーコード定義、入力制約などの抜粋をリソースとして公開し、コード生成の精度を高めます
• 動的パラメーターによって切り替える情報の提供: URIテンプレートを使い、可変パラメーターで内容が変わるリソースを提供します

これまでの特集でツール、プロンプト、リソースの主要要素に触れてきたので、ここで役割を振り返ります。

MCPのリソースは、URIの与え方によって2種類に分かれます。

MCPのリソースに関するメッセージは6種類あります。

※通知を検証するためには、リソースの源泉を別に設け　かつ　源泉側の変更検知も必要なため、サンプルには含めていません。

sequenceDiagram
  actor client as MCP Client
  participant server as MCP Server

  client ->> server: リソース一覧取得（resources/list）
  server -->> client: リソース一覧
  client ->> server: リソース取得（resources/read）
  server -->> client: リソース

• リソースコンテンツ
  • uri: リソースを一意に識別可能なURI
  • name: リソース名
  • title: 表示用のタイトル
  • description（任意）: リソースの説明
  • icons（任意）: アイコンリスト
  • mimeType（任意）: コンテンツのMIMEタイプ。テキストまたはバイナリ（Base64エンコードが必要）を指定可。
  • size（任意）: バイト数
• アノテーション（Annotations）: クライアントへのヒント
  • audience: 誰向けのリソースか示す情報。user, assistantまたは両方を指定可。
  • priority: 0.0～1.0の数値で示される重要度（1.0が最重要）
  • lastModified: 最終更新日時（ISO8601形式のタイムスタンプ）

リソースのURIには目的に応じたスキームを選びます。

コードの全体はこちらをご覧ください。

固定URIでリソースを公開する例です。
registerResourceの第2引数にURI文字列を渡すと静的リソースになります。

  // リソース: アノテーション付きの静的リソース（テキストコンテンツ）
  const testGuideUri = "memory://guides/testcase-prompt-playbook";
  server.registerResource(
    "testcase-prompt-playbook",
    testGuideUri,
    {
      mimeType: "text/markdown",
      description: "テスト観点生成のガイド",
      annotations: {
        audience: ["assistant"],           // AIへの参照情報として位置づける
        priority: 0.8,                     // 重要度（高め）
        lastModified: "2026-06-28T00:00:00Z",
      },
    },
    async () => ({
      contents: [{
        uri: testGuideUri, mimeType: "text/markdown",
        text: [
          // 実務ではもっと細かい指示が必要になりますが、行数を抑えるため最小限に留めています
          "# APIテストケース作成ガイド",
          "- 仕様の観点: 正常系、代替系、異常系、境界値、認可、冪等性",
          "- 基本フローの正常系を中心に、代替系、異常系、その他の観点を付加する形にまとめる。",
          "- ユースケースの検証を主眼とし、入力値検証などは含めない（単体テストで担保する）",
          "- 必要に応じて分類しながら、箇条書きで簡潔にまとめる",
        ].join("\n")
      }]
    }),
  );

• 動作確認: resources/readが確認できるPostmanで確認
  

バイナリコンテンツの指定例

バイナリコンテンツ（画像など）はblobにBase64エンコード文字列を設定します。

// リソース: バイナリコンテンツの例（画像）
server.registerResource(
  "company-logo",
  "file://assets/logo.png",
  { mimeType: "image/png", description: "企業ロゴ画像" },
  async () => ({
    contents: [{ uri: "file://assets/logo.png", mimeType: "image/png", blob: "<Base64エンコードされたデータ>" }],
  }),
);

ResourceTemplateクラスを使うと、URIテンプレート（RFC 6570）でパラメーター化されたリソースを公開できます。
{orderId}のようなプレースホルダーがリクエスト時に展開されます。
listコールバックはresources/listで返す候補一覧を定義します（省略不可、不要ならundefinedを渡します）。

resources/readリクエスト時、クライアントはorders://O00001/detailのようにテンプレートを展開したURIを指定します。
サーバー側では{orderId}部分が変数として分解され、ハンドラーに渡されます。

  // リソーステンプレート: URIのパラメータで内容が変わる動的リソース
  server.registerResource(
    "order-detail",
    new ResourceTemplate("orders://{orderId}/detail", {
      list: async () => ({
        resources: [
          { uri: "orders://O00001/detail", name: "O00001", mimeType: "application/json" },
          { uri: "orders://O00002/detail", name: "O00002", mimeType: "application/json" },
        ],
      }),
    }),
    { mimeType: "application/json", description: "受注詳細" },
    async (uri, { orderId }) => ({
      contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ orderId, status: "pending" }) }],
    }),
  );

• 動作確認
  • リソーステンプレートの確認: resources/templates/listが確認できるMCP Inspectorで確認
    
  • リソーステンプレートの実行確認: resources/readが確認できるPostmanで確認
    

• リソースは、AIへの参照情報を明示的に管理したい場合に有効です。
• 静的リソースは固定情報（ガイド、仕様など）、リソーステンプレートは可変情報（IDベースの詳細など）に向いています。
• アノテーションを設定することで、クライアントがリソースを適切に選択し、優先順位付けできます
• プロンプトと組み合わせると、生成指示と参照情報の両方を標準化できます