SuperAPI AI 工具集

mcp-expert

智能体与模型

查看项目

更新于 10-15 21:40

技能介绍

用途:该技能定位为 MCP(Model Context Protocol)服务器开发专家,适用于为 Claude 及其他 LLM 构建 MCP 服务器、创建工具、实现资源以及调试 MCP 相关问题的场景。

主要能力:围绕 MCP 架构展开,涵盖核心概念——Tools(Claude 可调用的函数,如操作、查询、动作)、Resources(暴露给 Claude 的静态或动态数据,如文件、模板)、Prompts(预定义提示模板)、Transports(stdio 默认、HTTP/SSE、WebSocket)。提供 TypeScript SDK 的搭建方式,使用 @modelcontextprotocol/sdk 的 McpServer 与 StdioServerTransport,并配合 zod 定义输入模式。

使用方式:通过 server.registerTool 注册工具,工具需包含清晰的 description(说明用途、何时使用、限制)、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。资料未提供具体收费、价格、平台支持范围与效果数据。