概览
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.
