SuperAPI AI 工具集

build-mcp-use-server

智能体与模型

查看项目

更新于 10-16 08:49

技能介绍

本技能面向使用 mcp-use/server 构建 TypeScript MCP 服务器的场景,侧重服务器端机制与 API 表面。触发条件包括:从 mcp-use/server 导入 MCPServer、text、object、mix、error、widget、Logger;定义或调整 server.tool()、server.resource()、server.prompt()、server.uiResource() 与 Zod schema;处理 ctx.auth、ctx.elicit()、ctx.sample()、ctx.notify()、ctx.client.can()、ctx.client.supportsApps() 等上下文能力;配置 Streamable HTTP、无状态、stdio 传输、会话存储、OAuth(DCR 或代理)、CORS、allowedOrigins、DNS 重绑定;构建 MCP Apps / ChatGPT Apps 组件(widgetMetadata、McpUseProvider、useCallTool、useWidget、CSP);运行 mcp-use dev、build、start、deploy、generate-types 或通过 Inspector / curl 在 /mcp 上握手调试;以及生产加固、健康检查、优雅关闭、速率限制与部署到 mcp-use Cloud、Vercel、Cloud Run、Fly、Cloudflare Workers、Deno Deploy、Supabase;也涵盖从原始 @modelcontextprotocol/sdk、mcp-use v1 或 appsSdk 迁移。

使用方式上,先锁定目标路径与执行模式:只读或环境受限时应输出仅计划,包含确切文件、安装命令、实现步骤与验证命令,不声称已运行验证。随后扫描现有 package.json、mcp-use/server 导入、MCPServer 实例与 server.tool 等信号;已有服务器优先改进而非重建。按意图选择分支:扩展现有服务器、全新 HTTP 工具服务器、严格 stdio、MCP Apps/ChatGPT 组件、Next.js 集成、认证/OAuth、会话与流式、部署加固、具体错误排查或迁移。核心规则包括从 mcp-use/server 导入服务器 API(Logger 例外来自 mcp-use)、在项目自身依赖中声明 zod、使用 mcp-use 的 HTTP/无服务器/会话/认证/组件模式而非手写原始 SDK 传输、严格 stdio 视为原始 SDK 需求。验证按层级如实报告:只读扫描、类型检查/构建、mcp-use dev 或 start、Inspector、curl 握手、test-by-mcpc-cli 会话、已部署端点。

不适用于导入 MCPClient、MCPSession、mcp-use/browser、mcp-use/react 的客户端工作,MCPAgent 编排,原始 SDK 服务器原语,或分层与导入方向等架构问题。其他具体细节与限制资料未提供。