Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

It is a template for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It allows developers to run MCP tools that can be accessed remotely over HTTP using SSE (Server-Sent Events) and authenticated via a login screen.

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. To deploy, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, and run npm run deploy. Connect using the MCP Inspector by selecting SSE transport and entering the server’s /sse URL (e.g., http://localhost:8787/sse locally or the workers.dev URL remotely). For Claude Desktop, use the mcp-remote proxy in the configuration file.

Key features of Remote MCP Server on Cloudflare

• Deploy MCP server on Cloudflare Workers with OAuth authentication
• Local development with live reload via npx nx dev
• Connect using MCP Inspector via SSE transport
• Integrate with Claude Desktop using the mcp-remote proxy
• OAuth login screen for access control
• Debugging support with command-line testing and auth cache clearing

Use cases of Remote MCP Server on Cloudflare

• Run a remote MCP server that can be accessed from anywhere via HTTP/SSE
• Connect Claude Desktop to custom MCP tools hosted on Cloudflare Workers
• Prototype and test MCP tools locally before deploying to production
• Add OAuth-based authentication to protect MCP endpoints

FAQ from Remote MCP Server on Cloudflare

What dependencies are required to run the server?

You need Node.js, npm, and npx. The README uses git clone, npm install, and npx commands throughout.

How do I connect the MCP Inspector to my remote server?

Open the MCP Inspector (npx @modelcontextprotocol/inspector), set Transport Type to SSE, enter the server’s URL followed by /sse (e.g., https://worker-name.account-name.workers.dev/sse), and click “Connect”. You will be redirected to a login screen.

Can I connect this MCP server to Claude Desktop?

Yes. In Claude Desktop’s configuration file, add a “math” entry with "command": "npx" and "args": ["mcp-remote", "https://your-worker.workers.dev/sse"]. Restart Claude to see the available tools.

Where does the OAuth data live?

The README uses a KV namespace named OAUTH_KV to store OAuth-related data. You create it with npx wrangler kv namespace create OAUTH_KV and configure the namespace ID in wrangler.jsonc.

How can I debug connection issues?

Restart Claude, or test directly from the command line with npx mcp-remote http://localhost:8787/sse. If needed, clear the auth cache by deleting ~/.mcp-auth with rm -rf ~/.mcp-auth.