remote-mcp-server-demo-demo

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, and integrating with Claude Desktop. The guide also covers deployment to Cloudflare and provides troubleshooting tips. The MCP server allows for OAuth login and can be accessed remotely, enabling users to explore and utilize MCP tools effectively. The document provides scripts and configurations for seamless integration and operation across different platforms.

Features

• Local Development: Instructions for setting up and running the MCP server locally using pnpm and npx.
• MCP Inspector Connection: Steps to connect the MCP Inspector to the server for exploring APIs.
• Claude Desktop Integration: Configuration for connecting Claude Desktop to the local and remote MCP server.
• Cloudflare Deployment: Guide to deploying the MCP server on Cloudflare Workers with OAuth login.
• Debugging Tips: Solutions for common issues, including restarting services and clearing authentication files.

Usage with Different Platforms

Develop Locally

bash
# clone the repository
git clone https://github.com/cloudflare/ai.git
# Or if using ssh:
# git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
# Note: using pnpm instead of just "npm"
pnpm 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