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 instructions for local development, connecting to the MCP Inspector, and integrating with Claude Desktop. The guide also covers deployment to Cloudflare and connecting to the server from a remote MCP client. The MCP server facilitates communication between different platforms and tools, allowing for seamless integration and tool invocation. The document provides step-by-step instructions, including necessary scripts and configurations, to ensure a smooth setup and deployment process.

Features

• Local Development: Instructions for setting up and running the MCP server locally using npm and nx.
• MCP Inspector Connection: Steps to connect the MCP Inspector to the server for API exploration.
• Claude Desktop Integration: Configuration details for connecting Claude Desktop to the local and remote MCP server.
• Cloudflare Deployment: Guidance on deploying the MCP server to Cloudflare Workers.
• Remote Client Connection: Instructions for connecting to the MCP server from a remote client.

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 MCP Inspector

bash
npx @modelcontextprotocol/inspector

Claude Desktop Configuration

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

Deploy to Cloudflare

bash
npx wrangler kv namespace create OAUTH_KV
npm run deploy

Remote MCP Client Connection

bash
npx @modelcontextprotocol/inspector@latest

Claude Remote Configuration

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

Debugging

bash
npx mcp-remote http://localhost:8787/sse
rm -rf ~/.mcp-auth