SuperAPI AI 工具集

typescript-mcp

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:该技能面向使用 TypeScript 在 Cloudflare Workers 上构建生产级 Model Context Protocol(MCP)服务器的场景,基于官方 @modelcontextprotocol/sdk,覆盖 HTTP 传输、鉴权模式、Cloudflare 服务集成与错误预防。

主要能力:支持注册工具(Tools,用 Zod 定义输入输出 schema)、资源(Resources,URI 寻址与模板参数)、提示词(Prompts)及可选的补全(Completions);提供基础服务器、工具服务器、资源服务器、带鉴权服务器等模板;集成 D1、KV、R2、Vectorize 等 Cloudflare 服务;包含 API Key、Cloudflare Zero Trust、OAuth 2.0 三种鉴权模式;并列出 10 余个常见生产问题及预防方式,如导出语法、传输连接未关闭、schema 校验失败、CORS、限流、环境变量泄漏等。

使用方式:安装依赖 npm install @modelcontextprotocol/sdk hono zod,开发依赖 npm install -D @cloudflare/workers-types wrangler typescript;本地运行 wrangler dev 或 npm run dev,部署使用 wrangler deploy。可用 Vitest 做单元测试,用 npx @modelcontextprotocol/inspector 做集成测试。

适用场景:为 LLM 暴露 API、工具或数据;在边缘部署无状态 MCP 端点;将 REST、GraphQL、数据库等外部 API 封装为 MCP 工具;通过 MCP 暴露 Cloudflare 服务;实现带鉴权的多工具 MCP 服务器。

限制:不适用于 Python MCP 服务器、需要 WebSocket 的有状态智能体、使用 SQLite 的长期持久智能体或本地 CLI 工具(应使用 stdio 传输)。资料未提供具体收费与价格信息。