Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template for deploying a remote Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools to remote clients like the MCP Inspector or Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy. Connect clients by pointing them to the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs as a Cloudflare Worker with OAuth login
• Uses SSE (Server-Sent Events) transport for MCP
• Includes a sample math tool (add)
• Supports local development and remote deployment
• Integrates with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP server that clients can authenticate with via OAuth
• Develop and test MCP tools locally before deploying to Cloudflare
• Connect Claude Desktop to a cloud-hosted MCP server using a local proxy
• Demonstrate a full MCP workflow from development to production

FAQ from Remote MCP Server on Cloudflare

How do I connect the MCP Inspector to my server?

Open the MCP Inspector, switch Transport Type to SSE, enter the server’s /sse URL, and click Connect. A mock login screen will appear; use any email and password to authenticate.

How do I connect Claude Desktop to my remote MCP server?

Edit the Claude Desktop config file to add an entry using npx mcp-remote with the server’s /sse URL (e.g., "command": "npx", "args": ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"]), then restart Claude.

What if something goes wrong?

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