mcp-server-builder

何时使用

当你需要为 LLM Agent 构建自定义工具服务器、封装 API 为 MCP 工具、或调试 MCP 连接时触发。

核心概念

MCP 架构

• Host：运行 LLM 的客户端（Claude Desktop、IDE 等）
• Client：与 Server 建立连接的中间层
• Server：暴露工具（Tools）、资源（Resources）、提示（Prompts）

工具定义

server.tool("query_database", 
  { sql: z.string().describe("SQL查询语句") },
  async ({ sql }) => {
    const result = await db.query(sql)
    return { content: [{ type: "text", text: JSON.stringify(result) }] }
  }
)

资源暴露

• 静态资源：server.resource() 注册固定 URI
• 动态资源：用模板 URI {id} 匹配参数
• 订阅机制：资源变更时通知客户端

传输层

• stdio：本地进程通信，最简单
• SSE：远程服务，HTTP 长连接
• 选择原则：本地用 stdio，远程用 SSE

安全

• 工具入参必须校验（Zod schema）
• 危险操作加确认提示（annotations.destructiveHint）
• 敏感数据不进 prompt，用资源按需加载