🚀 MCP Cloudflare工作模板
专业的服务器开发模板 MCP（模型上下文协议） 针对优化 Cloudflare员工 com TypeScript。
⚡ 为什么选择 Cloudflare Workers？
- ✅ 部署全局em segundos 在300多个城市的CDN
- ✅ 无服务器 零基础设施配置
- ✅ 自动扩展 处理数以百万计的请求
- ✅ 低成本 100000个请求/天免费
- ✅ 超低延迟 -边缘计算
- ✅ 快速发展 -热重载本地com检查器
🎯 两种方式的实践发展
1. 使用 Inspector 进行本地开发（完整调试）
npm run dev发生了什么：
- ✅ 自动编译 TypeScript
- ✅ 通过STDIO启动MCP服务器
- ✅ 打开检查员没有浏览器
- ✅ 自动连接
理想段落：
- 实时测试工具
- 查看客户端/服务器JSON消息
- 调试模式和有效性
- 快速开发功能
2. 部署到 Cloudflare Workers（生产）
npm run cf:dev # Testa localmente como Workers
npm run cf:deploy # Deploy global em segundos理想段落：
- 在真实环境中测试
- API HTTP公共协议
- Web 集成
- 可扩展生产
🚀 快速入门
安装
npm install开发
npm run dev此命令会自动打开检查器进行全面调试的开发。
📁 项目结构
mcp-cloudflare-workers-template/
├── src/
│ ├── index.ts # Servidor MCP via stdio (Inspector)
│ └── worker.ts # Versão Cloudflare Workers (HTTP)
├── dist/ # Código compilado
├── llms-full.txt # Documentação MCP oficial
├── wrangler.toml # Config Cloudflare Workers
├── tsconfig.json # Config TypeScript
└── package.json🔧 命令
| 命令 | 描述 |
|---|---|
npm run dev | 开发 -编译+检查器（自动tudo） |
npm run build | 编译TypeScript |
npm run cf:dev 如何在本地测试 Cloudflare Workers | |
npm run cf:deploy | 全球部署 -Publica na Cloudflare |
🛠️ 创建您的 MCP 工具
1. 定义工具
编辑 src/index.ts e src/worker.ts:
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
{
name: "buscar_usuario",
description: "Busca informações de um usuário",
inputSchema: {
type: "object",
properties: {
id: {
type: "string",
description: "ID do usuário",
},
},
required: ["id"],
},
},
],
};
});2.实现逻辑
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
switch (name) {
case "buscar_usuario":
// Sua lógica aqui
const usuario = await buscarUsuario((args as any).id);
return {
content: [
{
type: "text",
text: JSON.stringify(usuario),
},
],
};
}
});3.测试
npm run dev检查器会自动打开 。实时测试您的工具！
☁️ 部署准Cloudflare Workers
1.登录cloudflare
npx wrangler login2. 本地测试
npm run cf:dev可用的服务器 ： http://localhost:8787
可用的端点 ：
GET /health-健康检查GET /sse-服务器发送事件（流式传输）POST /tools/{nome}- 调用工具
3.全球部署
npm run cf:deploy准备好了！您的应用程序正在全球运行：
https://mcp-cloudflare-workers-template.seu-usuario.workers.dev🌐 在生产中使用
通过HTTP（Cloudflare Workers）
# Health check
curl https://your-worker.workers.dev/health
# Chamar ferramenta
curl -X POST https://your-worker.workers.dev/tools/echo \
-H "Content-Type: application/json" \
-d '{"message": "Hello MCP!"}'
# SSE Streaming
curl https://your-worker.workers.dev/sseVia Stdio（本地应用程序）
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({
command: "node",
args: ["dist/index.js"],
});
const client = new Client(
{ name: "my-client", version: "1.0.0" },
{ capabilities: {} }
);
await client.connect(transport);📋 本地与Cloudflare的区别
| Recurso | 本地（stdio） | Cloudflare Workers（HTTP） |
|---|
检查员 。✅ 是的❌ 不（使用HTTP端点） |调试|完成|通过console.log| |部署|-|全局，秒| | 可扩展性 | - | 自动，百万 req/s | |费用| - | 100k req/天免费 | 超低延迟（Edge）
📚 MCP 文档
此模板包括 llms-full.txt 完整的MCP文件。
资源 ：
🎓 使用范例
包含的工具
- 回声 返回已发送的消息
- 获取时间 - 返回当前时间戳
添加更多工具
模板是可扩展的。添加 ：
- 与外部API集成
- 数据库访问 （D1， KV）
- 数据处理
- 网络钩子
- 还有更多！
🤝 贡献
- Fork是模板
- 创建您的 feature branch
- 提交您的更改
- 推动一个分支
- Abra um Pull请求
📄 许可证
麻省理工学院
______________________________________________________________________
🚀 模板的优势
✅ 生产力 - npm run dev 并开始开发\ ✅ 可扩展 -全球自动部署\ ✅ 经济 - 无服务器，只需为使用付费\ ✅ 快速的 -热装+检验员集成\ ✅ 现代 -TypeScript+Cloudflare Workers
准备好了吗？ 执行 npm run dev 并开发您的 MCP 服务器！ （2）🚀