mcpField
C
cloudflare-mcp-server

cloudflare-mcp-server

github.com/secondsky开发240381 次安装5 周前更新
代码仓库

关于 cloudflare-mcp-server

面向在 Cloudflare Workers 上构建 MCP 服务的开发者，提供概念说明、参考文档和 TypeScript 模板。内容涉及工具、资源、提示词、传输方式及有状态服务部署。

主要功能

  1. 01MCP 核心概念说明
  2. 02工具、资源和提示词示例
  3. 03SSE、HTTP 与 WebSocket 传输
  4. 04Workers 和 Durable Objects 模板
  5. 05部署、测试与常见错误参考

适用场景

  1. 01搭建基础 MCP 服务
  2. 02选择 Workers 服务的传输方式
  3. 03使用 Durable Objects 构建有状态服务

MCP 相关

该技能指导如何构建 MCP 服务，并说明服务可向 MCP 客户端提供工具、资源和提示词。涵盖 SSE、HTTP 与 WebSocket 传输。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/secondsky/claude-skills --skill cloudflare-mcp-server

安装后在 Claude Code 中输入/cloudflare-mcp-server确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
authentication.md
common-issues.md
core-concepts.md
debugging-guide.md
error-catalog.md
http-transport-fundamentals.md
oauth-providers.md
official-examples.md
production-deployment.md
quick-start-guide.md
stateful-servers.md
transport-comparison.md
transport.md
worker-basics.md
templates/
basic-mcp-server.ts
basic-mcp.ts
claude_desktop_config.json
mcp-bearer-auth.ts
mcp-http-fundamentals.ts
mcp-oauth-proxy.ts
mcp-stateful-do.ts
mcp-with-d1.ts
mcp-with-workers-ai.ts
package.json
wrangler-basic.jsonc
wrangler-oauth.jsonc

详细介绍

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: 'Task',
  completed: false
}));

export default server;

核心概念

  • 工具：AI 可以调用的函数
  • 资源：AI 可以访问的数据
  • 提示词：可重复使用的模板
  • 传输方式：SSE、HTTP、WebSocket

工具示例

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 - 使用 DO 的有状态 MCP
  • templates/websocket-mcp.ts - WebSocket 传输方式

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

评论

支持 Markdown