Remote MCP Server on Cloudflare
@closerbrasil
Overview
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a guide and template to deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to run MCP servers that can be accessed remotely and integrated with MCP clients like 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. To deploy, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, and run npm run deploy. Connect via the MCP Inspector using SSE at http://localhost:8787/sse or an HTTPS workers.dev URL.
Key features of Remote MCP Server on Cloudflare
- OAuth login for authentication
- Local development with
npx nx dev - Deploy to Cloudflare Workers
- SSE transport protocol support
- Works with MCP Inspector and Claude Desktop
- Remote access via
workers.devURL
Use cases of Remote MCP Server on Cloudflare
- Running a remote MCP server for tool access from anywhere
- Connecting Claude Desktop to a remote MCP server via OAuth
- Testing MCP tools locally with the MCP Inspector
- Deploying a production-grade MCP server on Cloudflare’s edge
FAQ from Remote MCP Server on Cloudflare
How do I run the server locally?
Clone the repository, install dependencies, and run npx nx dev remote-mcp-server. Open http://localhost:8787/ in your browser.
How do I deploy to Cloudflare?
Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy.
How do I connect Claude Desktop to the remote server?
Update Claude’s configuration file to use npx mcp-remote with your server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude.
What if something goes wrong while connecting?
Restart Claude, or test the connection directly with npx mcp-remote http://localhost:8787/sse. If needed, clear the OAuth files in ~/.mcp-auth with rm -rf ~/.mcp-auth.
