cloudflare-mcp-server
Create Model Context Protocol servers running on Cloudflare Workers using TypeScript. Define tools, resources, and prompts that AI agents can invoke, with support for multiple transports including WebSocket and HTTP. Includes templates, deployment guides, and Durable Objects integration for stateful applications.
cloudflare-mcp-server lets you build and deploy Model Context Protocol servers on Cloudflare Workers.
AI-generated summary based on this skill's SKILL.md
Install
secondsky/claude-skills/cloudflare-mcp-server · repository language: TypeScript
git clone https://github.com/secondsky/claude-skills
cp -r claude-skills/plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server ~/.claude/skills/cloudflare-mcp-servernpx skillfed install secondsky/claude-skills/cloudflare-mcp-serverFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I build an MCP server on Cloudflare Workers?
cloudflare-mcp-server enables you to create Model Context Protocol servers directly on Cloudflare Workers using TypeScript. Start by defining your tools, resources, and prompts, then deploy using the provided templates. The skill supports multiple transports—WebSocket, HTTP, and SSE—so you can choose the best fit for your AI agent integration. Full deployment guides walk you through setup from local development to production.
What transports does cloudflare-mcp-server support?
cloudflare-mcp-server supports SSE, HTTP, and WebSocket transports for MCP communication. Each transport suits different use cases: WebSocket for real-time bidirectional messaging, HTTP for request-response patterns, and SSE for server-to-client streaming. Configure your preferred transport based on your AI agent's requirements and network constraints.
Can I create stateful MCP servers with Durable Objects?
Yes, cloudflare-mcp-server includes Durable Objects integration for building stateful MCP servers. Durable Objects provide consistent, low-latency state management across requests. The skill covers hibernation patterns, state coordination, and best practices for maintaining server state while handling concurrent MCP client connections reliably.
How do I define AI-callable tools and resources?
cloudflare-mcp-server lets you define tools and resources that AI agents can invoke. Tools are callable functions with input schemas and descriptions; resources are data artifacts agents can reference. The skill provides patterns for structuring tool definitions, handling parameters, and returning results in formats that AI systems expect, with examples for common use cases.
What authentication and error handling does cloudflare-mcp-server cover?
cloudflare-mcp-server includes production deployment patterns for authentication and error handling. Learn to secure your MCP endpoints, validate client requests, implement proper error responses, and handle edge cases. The skill covers token-based auth, request validation, and graceful failure modes to ensure your AI-callable tools remain reliable in production.
Is cloudflare-mcp-server suitable for quick prototyping?
Yes, cloudflare-mcp-server includes a quick start guide and example templates to get you prototyping immediately. The MIT license permits free use and modification. Deploy your first MCP server in minutes using pre-built patterns, then extend with custom tools, resources, and Durable Objects state as your application grows.
SKILL.md
rendered from the published skill — quoted content, verbatim
Cloudflare MCP Server
Last Updated: 2025-11-21
Quick Start
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;
Core Concepts
- Tools: Functions AI can call
- Resources: Data AI can access
- Prompts: Reusable templates
- Transports: SSE, HTTP, WebSocket
Example Tool
server.tool('searchDocs', {
description: 'Search documentation',
parameters: {
type: 'object',
properties: {
query: { type: 'string' }
}
},
handler: async ({ query }) => {
return { results: [...] };
}
});
Resources
Core Documentation
references/quick-start-guide.md(704 lines) - Official Cloudflare templates, complete step-by-step workflow, 5-minute setupreferences/core-concepts.md(66 lines) - MCP fundamentals: tools, resources, prompts,
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 15 files
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/SKILL.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/authentication.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/common-issues.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/core-concepts.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/debugging-guide.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/error-catalog.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/http-transport-fundamentals.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/oauth-providers.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/official-examples.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/production-deployment.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/quick-start-guide.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/stateful-servers.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/transport-comparison.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/transport.md
plugins/cloudflare-mcp-server/skills/cloudflare-mcp-server/references/worker-basics.md