cloudflare-mcp-server

用途

Cloudflare MCP Server 面向希望在 Cloudflare Workers 上构建 MCP（Model Context Protocol）服务器的开发者。MCP 服务器用于向 AI 提供可调用的工具、可访问的资源和可复用的提示模板。该资料聚焦于在 Cloudflare Workers 运行环境中实现这类服务器，并覆盖从快速搭建到生产部署的完整流程。

主要能力

资料围绕 MCP 的四个核心概念展开：

Tools（工具）：AI 可以调用的函数。
Resources（资源）：AI 可以访问的数据。
Prompts（提示）：可复用的模板。
Transports（传输）：SSE、HTTP、WebSocket。

同时提供有状态服务器的实现能力，包括 Durable Objects 集成、WebSocket 休眠（hibernation）以及成本优化相关主题。

使用方式

资料包含快速开始代码示例，展示如何通过 @modelcontextprotocol/sdk 的 McpServer 创建服务器并注册工具：

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

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

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

export default server;

工具定义可采用带描述、参数与处理函数的形式：

server.tool('searchDocs', {
  description: 'Search documentation',
  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：使用 Durable Objects 的有状态 MCP。
templates/websocket-mcp.ts：WebSocket 传输。

适用场景

适合需要在 Cloudflare Workers 上为 AI 应用提供 MCP 工具、资源与提示服务的开发者，以及需要构建有状态 MCP 服务器或使用 WebSocket 传输的场景。

限制

资料未提供具体的收费、价格、性能数据或效果承诺。部分代码示例中的返回内容以省略号示意，实际实现细节需参考对应参考文件。使用前提是熟悉 TypeScript 与 Cloudflare Workers 环境。

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

技能介绍

用途

主要能力

使用方式

参考资料结构

模板

适用场景

限制