Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is aimed at developers who want to deploy MCP tools that can be accessed remotely.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Connect via the MCP Inspector using SSE at http://localhost:8787/sse, or configure Claude Desktop to use the server through the mcp-remote proxy. Deploy to Cloudflare Workers with npm run deploy after creating an OAUTH_KV namespace.

Key features of Remote MCP Server on Cloudflare

• Deployable to Cloudflare Workers with one command
• OAuth login flow for remote access
• SSE (Server-Sent Events) transport for MCP communication
• Works with MCP Inspector for testing
• Connects to Claude Desktop via a local proxy
• Example math tools included for demonstration

Use cases of Remote MCP Server on Cloudflare

• Deploy MCP tools remotely on Cloudflare Workers for client access
• Test MCP server endpoints locally using the MCP Inspector
• Connect Claude Desktop to a remote server for tool invocation
• Build and debug custom MCP tools with OAuth authentication

FAQ from Remote MCP Server on Cloudflare

What runtime and dependencies are required?

Node.js and npm are needed for local development and deployment. A Cloudflare account is required to deploy to Workers.

What transport protocol does the server use?

SSE (Server-Sent Events) at the /sse endpoint.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy.

How do I connect Claude Desktop to the remote server?

Update the Claude Desktop configuration file to use the mcp-remote proxy pointing to your server's SSE URL (e.g., https://worker-name.account-name.workers.dev/sse).

How can I debug connection issues?

Run npx mcp-remote http://localhost:8787/sse from the command line to test the connection. Clearing files in ~/.mcp-auth may also help in rare cases.