Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A server that lets you run a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools via HTTP and connect them to 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. 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 (e.g., http://localhost:8787/sse locally or <workers.dev>/sse after deployment).

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth authentication
• Supports local development with hot reload
• Connects to MCP Inspector and Claude Desktop via SSE
• Simple CLI deployment using Wrangler
• Includes a mock login for local testing

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools accessible over the internet
• Building a remote math tool server that Claude can invoke
• Prototyping and testing MCP servers locally before deployment
• Integrating OAuth-based login into MCP workflows

FAQ from Remote MCP Server on Cloudflare

What do I need to run Remote MCP Server on Cloudflare locally?

Node.js and npm. Clone the repo, run npm install, then npx nx dev remote-mcp-server. It starts on http://localhost:8787/.

How do I connect the MCP Inspector to the server?

Open the MCP Inspector, set Transport Type to SSE, enter http://localhost:8787/sse (or your deployed URL) as the server URL, and click Connect. Use any email/password to log in locally.

How do I connect Claude Desktop to the remote server?

In Claude Desktop’s config file, add an entry using npx mcp-remote as the command and your server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse) as an argument.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL.

What should I do if something goes wrong?

Try restarting Claude, or test the server directly by running npx mcp-remote http://localhost:8787/sse. In rare cases, clear ~/.mcp-auth with rm -rf ~/.mcp-auth.