Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project to deploy a remote MCP server on Cloudflare Workers with OAuth login. It uses SSE transport and supports tools like a math calculator for use with MCP clients (e.g., Claude Desktop).

How to use Remote MCP Server on Cloudflare?

Clone the repo, install dependencies, run locally with npx nx dev remote-mcp-server, then connect via MCP Inspector using SSE at /sse. Deploy with npm run deploy after creating an OAUTH_KV namespace.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth authentication
• Supports SSE transport for MCP protocol
• Works with MCP Inspector for local testing
• Connects to Claude Desktop via a local proxy
• Easy one-command deployment to Cloudflare

Use cases of Remote MCP Server on Cloudflare

• Running a remote math tool from Claude Desktop
• Developing and testing MCP tools using the MCP Inspector
• Deploying a production MCP server on Cloudflare Workers
• Prototyping OAuth‑protected MCP endpoints

FAQ from Remote MCP Server on Cloudflare

How do I develop locally?

Clone [email protected]:cloudflare/ai.git, install with npm install, then run npx nx dev remote-mcp-server and open http://localhost:8787/.

How do I connect the MCP Inspector?

Run npx @modelcontextprotocol/inspector, switch transport to SSE, and enter http://localhost:8787/sse as the server URL. A mock login screen will appear.

How do I deploy to Cloudflare?

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

How do I connect Claude Desktop?

Edit Claude’s config file to add an entry with "command": "npx" and "args": ["mcp-remote", "<your-url>/sse"]. Restart Claude to see tools.

How do I debug issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse. If needed, clear cached auth files with rm -rf ~/.mcp-auth.