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

  // プロンプト：コードレビュー指示をテンプレート化
  server.registerPrompt(
    "code-review-prompt",
    {
      title: "code-review-prompt",
      description: "コードレビュー指示",
      // 引数スキーマの定義：MCP InspectorなどのMCPクライアントのUIで入力フォームとして表示され、サーバー側の関数に渡されます。
      argsSchema: {
        specPath: z.string().describe("仕様書パス"),
        codePath: z.string().describe("対象コードパス"),
      },
    },
    async ({ specPath, codePath }) => {
      return {
        messages: [
          // user: プロンプト本文
          {
            role: "user",
            content: {
              type: "text",
			        // 実務ではもっと細かい指示が必要になりますが、行数を抑えるため最小限に留めています
              text: [
                "コードレビュー指示",
                "あなたはNode.js/TypeScriptのバックエンド開発スペシャリストです。",
                "* 優先観点: 仕様整合性、例外設計、認可制御、トランザクション制御、性能、保守性、セキュリティ。",
                "* 禁止: 推測で仕様補完しない。根拠のない断定をしない。",
                "* 指摘の重大度: High(必須)/Medium(基本的に対応)/Low(できるだけ対応)を付ける。",
                "* 指摘は「問題」「対象個所」「修正案」を1行で示す。",
                "* 出力は最大10件、重複指摘は統合する。",
                "* 改善コードが必要なら最小差分で提案する。",
                `* 仕様書パス: ${specPath}`,
                `* 対象コードパス: ${codePath}`,
              ].join("\n"),
            },
          },
          // assistant: 見本
          {
            role: "assistant",
            content: {
              type: "text",
              text: ["（コードレビュー指摘の出力例）",
                "1. High: [問題] 仕様に記載のないAPIエンドポイントが存在する。 [対象個所] src/api/user.tsのgetUser関数。 [修正案] 不要なエンドポイントなら削除、仕様が古いなら更新して整合させる。",
				// omit
              ].join("\n")},
          },
        ],
      };
    },
  );

  // プロンプト: 指示やワークフローをテンプレート化。
  server.registerPrompt(
    "inventory-check-workflow",
    {
      title: "inventory-check-workflow",
      description: "在庫確認ワークフロー",
      argsSchema: {
        orderNo: z.string().describe("受注番号"),
      },
    },
    async ({ orderNo }) => {
      const prompt = [
        "在庫確認ワークフロー",
        `1. tools/callでget-orderを実行してください。（引数 orderNo: "${orderNo}"）`,
        "2. tools/callでcheck-attached-inventoryを実行してください。（引数: orderId: 1のレスポンスのorderId, quantity: 1のレスポンスのquantityの合計）",
        "3. 2のレスポンスのavailableがtrueなら「在庫引当済み」、falseなら「在庫不足」と返してください。",
      ].join("\n")
      return {messages: [{role: "user", content: {type: "text", text: prompt,}}]};
    },
  );
  server.registerTool(
    "get-order",
	// omit: 今回は固定値を返すだけの実装にしています
  );
  server.registerTool(
    "check-attached-inventory",
	// omit: 今回は固定値を返すだけの実装にしています
  );