Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project that runs a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a template for developers to deploy, test, and connect MCP tools to clients such as Claude Desktop or the MCP Inspector over SSE transport.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally via npx nx dev remote-mcp-server. Use the MCP Inspector or Claude Desktop (with npx mcp-remote) to connect to the server. Deploy to Cloudflare by creating an OAUTH_KV namespace with wrangler and running npm run deploy.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth-based login
• Supports SSE transport for MCP clients
• Includes local development and debugging instructions
• Integrates with the MCP Inspector for testing
• Connects directly to Claude Desktop via a remote proxy
• Provides a deployable server accessible at a workers.dev URL

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools accessible from any MCP client over the internet
• Developing and testing MCP integrations locally before deploying to Cloudflare
• Enabling Claude Desktop to call remote tools through an authenticated SSE endpoint
• Learning how to build and deploy a remote MCP server with OAuth flow

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repository, run npm install, and then execute npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How can I test the server with the MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector, switch transport to SSE, and enter http://localhost:8787/sse (or your workers.dev URL after deploy) as the server URL. You will be redirected to a login screen before you can list and call tools.

How do I connect Claude Desktop to the remote server?

Add an entry to Claude Desktop's config file with command npx, args ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"]. Restart Claude; a browser window will open for OAuth login.

What happens if something goes wrong?

Restart Claude, or test the connection manually with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the auth cache by deleting ~/.mcp-auth.

What runtime or dependencies are required?

Node.js and npm. For deployment, a Cloudflare account and npx wrangler are needed to create the OAUTH_KV namespace and deploy the Worker.