CloudflareMCP服务器构建 cloudflare-mcp-server

name: cloudflare-mcp-server description: 在Cloudflare Workers上使用工具、资源和提示构建MCP（Model Context Protocol）服务器。 license: MIT

Cloudflare MCP 服务器

最后更新: 2025-11-21

快速开始

import { McpServer } from '@modelcontextprotocol/sdk';

const server = new McpServer({
  name: 'my-server',
  version: '1.0.0'
});

server.tool('getTodo', async ({ id }) => ({
  id,
  title: '任务',
  completed: false
}));

export default server;

核心概念

• 工具: AI可以调用的函数
• 资源: AI可以访问的数据
• 提示: 可复用的模板
• 传输: SSE、HTTP、WebSocket

示例工具

server.tool('searchDocs', {
  description: '搜索文档',
  parameters: {
    type: 'object',
    properties: {
      query: { type: 'string' }
    }
  },
  handler: async ({ query }) => {
    return { results: [...] };
  }
});

资源

核心文档

• references/quick-start-guide.md (704行) - 官方Cloudflare模板，完整的逐步工作流程，5分钟设置
• references/core-concepts.md (66行) - MCP基础：工具、资源、提示、传输
• references/worker-basics.md (326行) - Worker和Durable Objects基础，传输选择，HTTP基础
• references/stateful-servers.md (246行) - Durable Objects集成，WebSocket休眠，成本优化，常见模式
• references/production-deployment.md (814行) - 部署与测试，配置参考，认证模式，22个已知错误及解决方案

模板

• templates/basic-mcp.ts - 最小MCP服务器
• templates/tools-example.ts - 工具定义
• templates/durable-object-mcp.ts - 使用DO的有状态MCP
• templates/websocket-mcp.ts - WebSocket传输

官方文档: https://modelcontextprotocol.io | Cloudflare: https://developers.cloudflare.com/workers/runtime-apis/durable-objects/