连接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（尽可能处理）。",
                "* 指出应以「问题」「对应位置」「修正方案」的形式在一行中展示。",
                "* 输出最多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，则返回“库存已分配”，否则返回“库存不足”。",
      ].join("\n");
      return { messages: [{ role: "user", content: { type: "text", text: prompt } }] };
    },
  );
  server.registerTool(
    "get-order",
    // omit: 本次仅实现为返回固定值
  );
  server.registerTool(
    "check-attached-inventory",
    // omit: 本次仅实现为返回固定值
  );