Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

It is a guide and starter to run a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools securely over the internet.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare by creating a KV namespace with npx wrangler kv namespace create OAUTH_KV, adding the ID to wrangler.jsonc, then running npm run deploy. Connect clients using Server-Sent Events (SSE) at the /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for global edge deployment.
• Includes OAuth login for secure access.
• Supports SSE transport for MCP clients.
• Works with MCP Inspector and Claude Desktop.
• Provides local development with mock authentication.

Use cases of Remote MCP Server on Cloudflare

• Hosting MCP tools that need to be accessed remotely by AI assistants.
• Building and testing custom MCP servers locally before deploying.
• Integrating Claude Desktop with custom tools via a remote proxy.

FAQ from Remote MCP Server on Cloudflare

How do I connect the MCP Inspector to my server?

In the Inspector, switch Transport Type to SSE and enter http://localhost:8787/sse (or your remote URL) as the server URL, then click Connect. You will be prompted to log in with any email and password.

How do I connect Claude Desktop to my remote server?

Edit Claude Desktop’s config file to add an entry with "command": "npx" and "args": ["mcp-remote", "https://your-worker-url/sse"]. Restart Claude; a browser window will open for OAuth login.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV and follow the guidance to add the KV namespace ID to wrangler.jsonc. Then run npm run deploy. Your server will be available at a workers.dev URL.

What transport protocol does the server use?

It uses Server-Sent Events (SSE) at the /sse endpoint. Clients connect via the mcp-remote proxy or MCP Inspector with SSE transport.

How do I debug connection issues?

Restart Claude, try connecting directly with npx mcp-remote http://localhost:8787/sse, or clear cached auth files with rm -rf ~/.mcp-auth.