Remote MCP Server On Cloudflare P86

🚀 Remote MCP Server Setup on Cloudflare

Let's build a remote MCP server running on Cloudflare Workers and integrate OAuth login functionality!

🚀 Quick Start

📦 Installation

# 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

You should be able to open the browser window at http://localhost:8787/ for access.

💻 Usage Examples

Connect MCP Inspector to Your Server

To explore the new MCP API, you can use the MCP Inspector.

• Start it with the command: npx @modelcontextprotocol/inspector
• In the Inspector, switch the Transport Type to SSE, enter http://localhost:8787/sse as the URL of the MCP server, and then click "Connect".
• You'll enter a (simulated) user login interface. Enter any email and password to log in.
• After successful login, you'll be redirected back to the MCP Inspector and can list and call any defined tools!

Connect Claude Desktop to the Local MCP Server

The MCP inspector is very useful, but what we really want is to integrate it with Claude! Follow the Anthropic's Quick Start Guide, go to Settings > Developer > Edit Profile in Claude Desktop to find your profile.

Open the file with a text editor and replace its contents with the following configuration:

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

This will run a local proxy, allowing Claude to communicate with your MCP server via HTTP.

When opening Claude, a browser window should pop up automatically, prompting you to log in. You should be able to see the list of available tools in the bottom-right corner of the screen. Depending on the correct prompts, Claude may request to call a tool.

🚀 Deployment to Cloudflare

# Create a KV namespace
cf create-namespace --name mcp-namespace

# Update the wrangler.jsonc file with the following content:
{
  "kv-namespaces": {
    "mcp-namespace": "your-namespace-id"
  }
}

🔧 Debugging

# Restart Claude
# Clear the authentication file
rm -rf ~/.config/mcp/.auth

Throughout the process, if you encounter any issues, make sure to follow the steps strictly and check the output of each step for possible error messages.