SuperAPI AI 工具集

mcp-development

编程与开发

查看项目

更新于 10-15 23:39

技能介绍

用途:该技能面向 MCP(Model Context Protocol)服务器开发,覆盖工具设计、资源端点、提示模板与传输配置四类工作。

主要能力:示例以 @modelcontextprotocol/sdk 为基础,用 McpServer 注册工具,配 Zod 定义参数(如 search_files 的 glob 模式与目录、run_query 的 SQL 与 limit);run_query 仅允许 SELECT,否则返回 isError: true。资源通过 server.resource 暴露只读数据,如 db://schema 返回数据库结构与关系、config://app 返回经 redactSecrets 脱敏的应用配置。提示模板用 server.prompt,如 review-code 接收 diff 与 focus 枚举,生成结构化评审起点。

使用方式:客户端配置写在 mcpServers 中,本地服务器用 command/args/env(如 node ./mcp-server/dist/index.js 与 DATABASE_URL),远程服务器用 url 与 headers(如 SSE 地址和 Bearer 令牌)。传输方面用 StdioServerTransport 并 server.connect(transport);基于 HTTP 的服务器使用 SSE 传输实现流式响应。

反模式与检查项:避免工具描述含糊、不用 Zod 校验输入、把原始错误堆栈返回客户端、错误响应缺少 isError: true、工具过细而非可组合、资源响应不脱敏密钥。检查清单包括工具描述清晰、参数校验、错误友好、资源只读脱敏、提示模板结构化、处理 SIGINT/SIGTERM 优雅关闭、工具可组合,以及文档化客户端配置与必需环境变量。

限制:资料未提供具体安装命令、版本要求、定价或平台支持信息。