Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A scaffold to get a remote MCP server running on Cloudflare Workers with OAuth login. It provides local development, deployment, and connection to MCP clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repo, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy with npm run deploy after creating a Cloudflare KV namespace. Connect tools via SSE at the /sse endpoint using the MCP Inspector or Claude Desktop.

Key features of Remote MCP Server on Cloudflare

• OAuth login integrated for authentication.
• Local development with live reload.
• One‑command deployment to Cloudflare Workers.
• Uses SSE transport for MCP communication.
• Works with MCP Inspector and Claude Desktop.

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools for AI assistants remotely.
• Developing and testing MCP servers locally.
• Deploying an authenticated MCP server behind Cloudflare.
• Connecting Claude Desktop to a remote tool server.

FAQ from Remote MCP Server on Cloudflare

How do I test my server locally?

Run npx @modelcontextprotocol/inspector, select SSE transport, and enter http://localhost:8787/sse. A mock login screen appears; input any credentials to connect.

How do I connect Claude Desktop to the server?

Edit Claude Desktop’s config file to add an mcpServers entry using npx mcp-remote with the SSE URL of your local or deployed server.

What are the deployment steps?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy.

How can I debug connection issues?

Run npx mcp-remote http://localhost:8787/sse directly, or clear cached auth files with rm -rf ~/.mcp-auth.

What transport does the server use?

It uses SSE (Server‑Sent Events) at the /sse endpoint.