skillfed

building-mcp-server-on-cloudflare

This skill guides you through creating and deploying Model Context Protocol servers on Cloudflare Workers, complete with custom tools and optional OAuth authentication. Define tools using TypeScript, configure your server entry point, test locally with the MCP Inspector, then deploy to Workers in minutes. Includes patterns for input validation, environment bindings, and connecting clients like Claude Desktop.

Building MCP Server on Cloudflare creates production-ready Model Context Protocol servers on Cloudflare Workers with tools and authentication.

AI-generated summary based on this skill's SKILL.md

★ 0  0 Apache-2.0 updated by null-shot

Install

null-shot/cloudflare-skills/building-mcp-server-on-cloudflare · repository language: TypeScript

git clone https://github.com/null-shot/cloudflare-skills
cp -r cloudflare-skills/building-mcp-server-on-cloudflare ~/.claude/skills/building-mcp-server-on-cloudflare
npx skillfed install null-shot/cloudflare-skills/building-mcp-server-on-cloudflare

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How do I build an MCP server on Cloudflare Workers?

Building-mcp-server-on-cloudflare guides you through creating a Model Context Protocol server using TypeScript on Cloudflare Workers. Start by defining your tools with input schemas, implement handler functions, then wrap them in an MCP server instance. Use wrangler to configure your Worker, set environment variables for secrets, and deploy with a single command. The skill covers local testing via MCP Inspector before production deployment.

How do I set up MCP with OAuth authentication on Cloudflare?

Building-mcp-server-on-cloudflare includes patterns for adding OAuth to your MCP server. Integrate an OAuth provider (like GitHub) by storing credentials in Cloudflare environment bindings, validating tokens in your server middleware, and returning authentication errors for invalid requests. The skill shows how to configure OAuth scopes, handle token refresh, and secure your MCP endpoint so only authorized clients can call your tools.

What's the process to expose tools via the Model Context Protocol?

Building-mcp-server-on-cloudflare teaches tool definition by creating TypeScript objects with name, description, and inputSchema properties. Each tool maps to a handler function that processes client requests. Define input validation schemas using JSON Schema, implement error handling, and register tools with your MCP server instance. The skill demonstrates how clients like Claude Desktop discover and invoke your tools once deployed.

How can I deploy an MCP remote server endpoint on Cloudflare?

Building-mcp-server-on-cloudflare walks through deploying your MCP server to Cloudflare Workers using wrangler. Configure your wrangler.toml with service bindings and environment variables, test locally with MCP Inspector, then run `wrangler deploy`. Your server gets a public HTTPS endpoint that MCP clients connect to. The skill covers configuring CORS, handling concurrent requests, and monitoring your deployed server.

How do I connect MCP clients to a Cloudflare-hosted endpoint?

Building-mcp-server-on-cloudflare shows how to configure MCP clients like Claude Desktop to connect to your Workers endpoint. Add your server URL to the client configuration file, specify authentication headers if using OAuth, and test the connection. The skill includes troubleshooting steps for connection failures, timeout issues, and verifying that your tools are discoverable by the client.

What tools and functions can I define in an MCP server?

Building-mcp-server-on-cloudflare demonstrates defining diverse tools—from simple utilities to complex integrations. Each tool requires a name, description, and inputSchema defining parameters. Implement handlers that validate inputs, call external APIs or Cloudflare services, and return structured results. The skill covers error handling, logging, and best practices for tool design to ensure reliable client interactions.

SKILL.md

rendered from the published skill — quoted content, verbatim

Building MCP Servers on Cloudflare

Creates production-ready Model Context Protocol servers on Cloudflare Workers with tools, authentication, and deployment.

When to Use

  • User wants to build a remote MCP server
  • User needs to expose tools via MCP
  • User asks about MCP authentication or OAuth
  • User wants to deploy MCP to Cloudflare Workers

Prerequisites

  • Cloudflare account with Workers enabled
  • Node.js 18+ and npm/pnpm/yarn
  • Wrangler CLI (npm install -g wrangler)

Quick Start

Option 1: Public Server (No Auth)
npm create cloudflare@latest -- my-mcp-server \
  --template=cloudflare/ai/demos/remote-mcp-authless
cd my-mcp-server
npm start

Server

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 4 files 
building-mcp-server-on-cloudflare/SKILL.md
building-mcp-server-on-cloudflare/references/examples.md
building-mcp-server-on-cloudflare/references/oauth-setup.md
building-mcp-server-on-cloudflare/references/troubleshooting.md

Related skills

Remote Mcp Server With Auth (NOASSERTION) agents-sdk (Apache-2.0) cloudflare-workers-security (MIT) Mcp Quickstart Scaffolder (NOASSERTION) tanstack-start (MIT) cloudflare (MIT) agents-sdk (MIT) cloudflare-knowledge (MIT) cloudflare-workers-publish (MIT)
All skills by null-shot →

Tags

serverless-deployment protocol-implementation tool-exposure oauth-integration api-gateway edge-computing client-connection production-ready