Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project to set up a remote MCP server on Cloudflare Workers with OAuth login. It provides a complete workflow for developing locally, deploying to Cloudflare, and connecting MCP clients like the MCP Inspector or Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare Workers using npm run deploy after creating a KV namespace for OAuth. Connect clients via SSE by pointing them to the /sse endpoint, using npx mcp-remote for Claude Desktop.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth login
• Uses SSE transport for MCP communication
• Includes local development and deployment scripts
• Integrates with MCP Inspector for testing
• Connects to Claude Desktop via proxy client

Use cases of Remote MCP Server on Cloudflare

• Deploying a remote MCP server accessible over the internet
• Testing MCP tools locally before deployment
• Connecting Claude Desktop to custom MCP tools with OAuth
• Building and iterating on MCP tool definitions

FAQ from Remote MCP Server on Cloudflare

What do I need to run the server locally?

You need Node.js and npm. Clone the repository, install dependencies, then run npx nx dev remote-mcp-server and open http://localhost:8787/.

How do I deploy the server to Cloudflare?

Run npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv, add the KV namespace ID to wrangler.jsonc, then execute npm run deploy.

How can I connect Claude Desktop to my remote server?

Update Claude's config file to use npx mcp-remote with your Workers URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude and a browser login window will appear.

What transport does the MCP server use?

The server uses SSE (Server-Sent Events) as the transport type. Clients connect to the /sse endpoint.

How can I debug connection issues?

Run npx mcp-remote http://localhost:8787/sse directly on the command line. In rare cases, clear the OAuth files with rm -rf ~/.mcp-auth.