SuperAPI AI 工具集

typescript-mcp

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:该技能面向在 Cloudflare Workers 上用 TypeScript 构建 MCP(Model Context Protocol)服务器的场景,覆盖工具、资源、提示、任务、认证与 Cloudflare 服务集成。

主要能力:提供基于 @modelcontextprotocol/sdk、hono、zod 的服务器搭建方式;推荐生产使用 StreamableHTTPServerTransport(SSE 传输已弃用,仅为向后兼容保留);支持 API Key(KV)、Cloudflare Zero Trust 等认证;支持任务(v1.24.0+,状态为 working → input_required → completed/failed/cancelled)与带工具的采样(SEP-1577);可集成 D1、KV、R2、Vectorize 等 Cloudflare 服务。

必要用法:安装命令为 npm install @modelcontextprotocol/sdk@latest hono zod 与 npm install -D @cloudflare/workers-types wrangler typescript;部署使用 wrangler deploy。需注意直接导出 export default app(而非 { fetch: app.fetch })、为每个 HTTP 会话创建新的 McpServer 实例、设置 transport.onerror、在响应结束时调用 transport.close()、配置 CORS 与限流,并避免记录 env 对象。

适用场景:需要部署在 Cloudflare Workers 上的 MCP 服务器、需要长任务轮询、服务端智能体循环或访问 Cloudflare 数据服务的项目。

限制:资料未提供具体收费、价格与效果数据;部分问题(如任务错误包装、请求处理器取消)暂无官方修复,仅有变通方案;使用 exactOptionalPropertyTypes 时需注意 sessionIdGenerator 类型问题,SDK 1.25.0–1.25.2 存在 global.fetch 污染,建议升级至 1.25.3。