anandkumarpatel_remote-mcp-server

anandkumarpatel_remote-mcp-server

3.3

This document provides a guide to setting up a remote Model Context Protocol (MCP) server on Cloudflare Workers, including local development, connection to MCP Inspector, and integration with Claude Desktop.

The Remote MCP Server on Cloudflare guide is designed to help users set 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 troubleshooting tips. The MCP server allows for OAuth login and can be accessed remotely, enabling users to explore and utilize MCP tools effectively. By following the steps outlined, users can create a robust MCP server environment that supports various applications and platforms.

Features

  • Local Development: Instructions for setting up and running the MCP server locally using Node.js and npm.
  • MCP Inspector Connection: Steps to connect the MCP Inspector to the server for exploring APIs and tools.
  • Claude Desktop Integration: Guide to configure Claude Desktop to interact with the local MCP server.
  • Cloudflare Deployment: Instructions for deploying the MCP server to Cloudflare Workers.
  • Remote Access: Ability to connect to the MCP server from remote clients using the workers.dev URL.

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