Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A reference implementation that demonstrates how to run a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login, enabling AI clients like Claude Desktop to call tools over HTTP.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For production, deploy to Cloudflare Workers using npm run deploy after creating a KV namespace. Connect via MCP Inspector or configure a Claude Desktop client with the remote SSE URL.

Key features of Remote MCP Server on Cloudflare

• Deploy a remote MCP server on Cloudflare Workers
• OAuth-based authentication via Cloudflare Workers
• Local development with hot reload
• SSE transport for MCP communication
• Integration with MCP Inspector for testing
• Compatible with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

• Run an MCP server remotely for cloud-hosted AI assistants
• Add tool-calling capabilities to Claude Desktop from a serverless endpoint
• Prototype and test MCP tools locally before deploying globally
• Demonstrate OAuth login flow for MCP servers

FAQ from Remote MCP Server on Cloudflare

What do I need to run this locally?

You need Node.js and npm. Clone the repo, install dependencies, then run npx nx dev remote-mcp-server to start the local server at http://localhost:8787.

How do I connect a remote MCP client to the deployed server?

Use the MCP Inspector with SSE transport and enter your Workers URL (e.g., https://worker-name.account-name.workers.dev/sse), then click Connect. For Claude Desktop, update its config with npx mcp-remote pointing to the same URL.

What authentication does the server use?

The server includes OAuth login. When connecting via MCP Inspector or Claude Desktop, you will be redirected to a login screen (mock in local development) that authenticates before tool access is granted.

What are the deployment requirements?

You need a Cloudflare Workers account and must create a KV namespace via npx wrangler kv namespace create OAUTH_KV. Add the namespace ID to wrangler.jsonc before running npm run deploy.

How do I debug connection issues?

Restart Claude or try connecting directly from the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the auth cache by running rm -rf ~/.mcp-auth.