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 provides debugging 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 remote MCP server with OAuth login, explore the MCP API using the MCP Inspector, and connect the server to Claude Desktop for enhanced functionality.

Features

• Local Development: Instructions for setting up and running the MCP server locally.
• MCP Inspector Connection: Steps to connect the MCP Inspector to the MCP server for API exploration.
• Claude Desktop Integration: Guide to connect Claude Desktop to the MCP server for tool invocation.
• Cloudflare Deployment: Instructions for deploying the MCP server to Cloudflare Workers.
• Debugging Tips: Solutions for common issues encountered during setup and connection.

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

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 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
rm -rf ~/.mcp-auth