Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a ready-to-run example for developers who want to expose MCP tools over the internet and connect them to clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally using npx nx dev remote-mcp-server. Connect the MCP Inspector by setting Transport Type to SSE and the URL to http://localhost:8787/sse. For Claude Desktop, update its configuration file with a npx mcp-remote command pointing to the server's SSE endpoint. Deploy to Cloudflare with npm run deploy after creating a KV namespace and adding its ID to wrangler.jsonc.

Key features of Remote MCP Server on Cloudflare

• Local development with hot-reload via Nx.
• OAuth login included for secure access.
• Connect via MCP Inspector for testing.
• Integrates with Claude Desktop through a local proxy.
• Deploy to Cloudflare Workers with one command.
• Debugging helpers like mcp-remote and auth cache clearing.

Use cases of Remote MCP Server on Cloudflare

• Deploying math or other tool servers remotely for AI assistants.
• Building and testing MCP tools locally before deployment.
• Enabling Claude Desktop to call tools hosted on Cloudflare.
• Creating a remote tool server with OAuth authentication.

FAQ from Remote MCP Server on Cloudflare

How do I debug connection issues?

Restart Claude, or try connecting directly using npx mcp-remote http://localhost:8787/sse. If problems persist, clear the auth cache with rm -rf ~/.mcp-auth.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy.

How do I connect the MCP Inspector?

Start it with npx @modelcontextprotocol/inspector, switch Transport Type to SSE, enter the server's SSE URL (e.g., http://localhost:8787/sse), and click Connect. You will see a mock login screen.

What dependencies or runtime does this server require?

It runs on Cloudflare Workers and uses a KV namespace for OAuth data. Local development requires Node.js and npm.

Does the server include a real authentication provider?

No, the included OAuth screen is a mock. You can enter any email and password to log in locally. For production, you would replace it with a real OAuth provider.