remote-mcp-server-2

The Remote MCP Server on Cloudflare guide details the process of setting up a Model Context Protocol server using Cloudflare Workers. It includes steps for local development, connecting to the MCP Inspector, integrating with Claude Desktop, and deploying the server to Cloudflare. The guide also covers debugging tips and provides configuration scripts for connecting to the server from different platforms. The MCP server allows for OAuth login and can be accessed remotely, enabling users to explore and utilize defined tools through the MCP Inspector and Claude Desktop.

Features

• Local Development: Instructions for setting up and running the MCP server locally using npm and nx.
• MCP Inspector Integration: Steps to connect the MCP Inspector to the server for exploring APIs.
• Claude Desktop Integration: Configuration for connecting Claude Desktop to the MCP server.
• Cloudflare Deployment: Guide to deploying the MCP server on Cloudflare Workers.
• Debugging Tips: Suggestions for troubleshooting common issues with the MCP server.

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"
      ]
    }
  }
}