Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

This project provides a template and guide to deploy a remote MCP server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools over the internet with authentication.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, and run npm run deploy. Connect clients like the MCP Inspector or Claude Desktop via the SSE endpoint (/sse) using the mcp-remote proxy.

Key features of Remote MCP Server on Cloudflare

• Deploy MCP server on Cloudflare Workers.
• Includes OAuth login for secure access.
• Local development with mock login.
• Connect MCP Inspector or Claude Desktop.
• Remote access via workers.dev URL.
• Uses SSE transport protocol.

Use cases of Remote MCP Server on Cloudflare

• Expose MCP tools (e.g., math functions) to AI assistants like Claude.
• Develop and test MCP servers locally before deploying.
• Build authenticated MCP APIs on Cloudflare's edge network.

FAQ from Remote MCP Server on Cloudflare

What is the purpose of this project?

It provides a remote MCP server on Cloudflare Workers with OAuth login, enabling AI clients to call tools securely.

How do I run the server locally?

Clone the repo, install dependencies, and run npx nx dev remote-mcp-server. Then connect clients to http://localhost:8787/sse.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy.

How do I connect Claude Desktop?

Add an entry to Claude Desktop's config file using npx mcp-remote pointing to your server's SSE URL (local or remote).

What transport protocol is used?

The server uses SSE (Server-Sent Events) as the transport protocol. Clients connect to the /sse endpoint.