Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a reference implementation that deploys a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login, enabling remote tool calling from MCP clients like Claude Desktop.

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 by creating an OAuth KV namespace, adding its ID to wrangler.jsonc, and running npm run deploy. Connect MCP clients via an SSE endpoint (e.g., http://localhost:8787/sse locally or the workers.dev/sse URL after deployment).

Key features of Remote MCP Server on Cloudflare

• Runs an MCP server on Cloudflare Workers
• Includes OAuth login flow for authentication
• Supports SSE transport for MCP connections
• Integrates with MCP Inspector for testing
• Works with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP server accessible over the internet
• Develop and test MCP tools locally before deployment
• Connect Claude Desktop to custom MCP tool sets
• Prototype OAuth-secured MCP interactions

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

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

How do I deploy to Cloudflare?

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

How do I connect Claude Desktop to my server?

Edit your Claude Desktop configuration file and add an entry with "command": "npx", "args": ["mcp-remote", "<your-sse-url>"]. Use http://localhost:8787/sse for local or the workers.dev/sse URL for remote.

What should I do if something goes wrong?

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