用途:该技能定位为 MCP 服务器开发专家,适用于为 Claude 及其他 LLM 构建 MCP 服务器、创建工具、实现资源、调试 MCP 以及完成相关配置。
主要能力:覆盖 MCP 架构核心概念,包括 Tools(Claude 可调用的函数,如操作、查询、动作)、Resources(暴露给 Claude 的静态或动态数据,如文件、模板)、Prompts(预定义提示模板)以及 Transports(stdio 默认、HTTP/SSE、WebSocket)。提供 TypeScript SDK 的搭建方式,使用 @modelcontextprotocol/sdk 的 McpServer 与 StdioServerTransport,并配合 zod 定义输入模式。
使用方式:通过 server.registerTool 注册工具,工具需包含清晰描述(说明何时使用与限制)、inputSchema(用 z.object 定义参数,并用 .describe() 标注每个字段,可设置默认值与上限如 max 1000)。返回值分为成功与错误两种结构:成功返回 content 文本与 structuredContent;错误返回 content 文本并设置 isError: true。日志必须使用 console.error,因为 stdio 服务器的 stdout 用于协议通信。Claude 配置通过 mcpServers 指定 command、args 与 env。测试可使用 npx @modelcontextprotocol/inspector 进行交互式调试。
最佳实践与限制:安全方面要求用 Zod 校验所有输入、使用参数化查询而非拼接 SQL、数据库用户遵循最小权限、对昂贵操作限流、输出中脱敏敏感数据。工具设计遵循单一职责、命名具描述性(如 sql_select、file_read)、描述清晰、模式详细、显式限制(maxRows、timeout、maxSize)。错误处理需捕获异常并返回 isError。资料未提供具体收费、价格、平台支持范围与效果数据。