remote-mcp-server

The Remote MCP Server on Cloudflare guide details the process of deploying a Model Context Protocol server using Cloudflare Workers. It includes steps for local development, connecting to the MCP Inspector for API exploration, and integrating with Claude Desktop for enhanced functionality. The guide also covers deployment to Cloudflare and provides troubleshooting tips. The MCP server facilitates communication between different platforms and tools, allowing for seamless integration and tool invocation. By following the guide, users can set up a robust MCP server environment that supports OAuth login and remote client connections.

Features

• Local Development: Instructions for setting up and running the MCP server locally using Node.js and npm.
• MCP Inspector Integration: Steps to connect the MCP Inspector to the server for API exploration and tool invocation.
• Claude Desktop Integration: Configuration guidance for connecting Claude Desktop to the MCP server for enhanced tool usage.
• Cloudflare Deployment: Detailed steps for deploying the MCP server to Cloudflare Workers, including OAuth setup.
• Debugging Tips: Provides troubleshooting advice for common issues encountered during setup and deployment.

Usage with Different Platforms

Develop locally

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

Connect Claude Desktop locally

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

Deploy to Cloudflare

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

Connect Claude Desktop remotely

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

Debugging

bash
npx mcp-remote http://localhost:8787/sse
# In some rare cases it may help to clear the files added to `~/.mcp-auth`
rm -rf ~/.mcp-auth