remote-mcp-server

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 for API exploration, and integrating with Claude Desktop for enhanced functionality. The guide also covers deployment to Cloudflare and provides troubleshooting tips for common issues. By following this guide, users can effectively manage and utilize MCP servers for various applications, leveraging the power of Cloudflare's infrastructure and the flexibility of MCP technology.

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: Guide to configuring Claude Desktop to interact with the MCP server, enabling tool usage within the application.
• Cloudflare Deployment: Detailed process for deploying the MCP server to Cloudflare Workers, including KV namespace setup.
• Troubleshooting: Tips for resolving common issues, including restarting services and clearing authentication files.

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