Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It provides local development, deployment, and integration with MCP clients like Claude Desktop and the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npx wrangler kv namespace create OAUTH_KV and npm run deploy. Connect clients by pointing them to the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Run an MCP server with OAuth login
• Develop locally with hot reload
• Deploy to Cloudflare Workers
• Connect via SSE transport
• Integrate with MCP Inspector tool
• Connect Claude Desktop as a remote MCP client

Use cases of Remote MCP Server on Cloudflare

• Building and testing a custom MCP server locally
• Providing a remote MCP endpoint for AI assistants
• Deploying a secure OAuth-protected MCP server in production
• Connecting Claude Desktop to a remote MCP server

FAQ from Remote MCP Server on Cloudflare

How do I develop the server locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. Open http://localhost:8787/ in your browser.

How do I connect the MCP Inspector to my server?

Start the inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter http://localhost:8787/sse as the URL. You’ll be redirected to a mock login screen.

How do I connect Claude Desktop to my local server?

Edit Claude Desktop’s configuration file and add an entry with "command": "npx", "args": ["mcp-remote", "http://localhost:8787/sse"]. A browser window will open for login.

How do I deploy the server to Cloudflare?

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

What should I do if something goes wrong?

Restart Claude, try connecting via command line with npx mcp-remote http://localhost:8787/sse, or clear ~/.mcp-auth with rm -rf ~/.mcp-auth.