remote-mcp-server

The Remote MCP Server on Cloudflare guide is designed to help users set up and deploy a Model Context Protocol server using Cloudflare Workers. The guide covers local development, connecting to the MCP Inspector, integrating with Claude Desktop, and deploying the server to Cloudflare. It provides detailed instructions for setting up OAuth login, configuring the MCP Inspector, and connecting Claude Desktop to both local and remote MCP servers. The guide also includes troubleshooting tips for common issues that may arise during setup and deployment.

Features

• Local Development: Instructions for setting up and running the MCP server locally using npm and npx.
• MCP Inspector Integration: Steps to connect the MCP Inspector to the local MCP server for API exploration.
• Claude Desktop Integration: Configuration guidance for connecting Claude Desktop to the MCP server.
• Cloudflare Deployment: Detailed steps for deploying the MCP server to Cloudflare Workers.
• Debugging Tips: Solutions for common issues encountered during setup and deployment.

Usage with Different Platforms

local_development

bash
# clone the repository
git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
npm install

# run locally
npx nx dev remote-mcp-server

mcp_inspector

bash
npx @modelcontextprotocol/inspector

claude_desktop_local

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

cloudflare_deployment

bash
npx wrangler kv namespace create OAUTH_KV
# Follow the guidance to add the kv namespace ID to `wrangler.jsonc`
npm run deploy

claude_desktop_remote

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://worker-name.account-name.workers.dev/sse"
      ]
    }
  }
}