Remote

You set up a remote MCP server that runs on Cloudflare Workers, enabling an MCP API with OAuth login and a pathway to connect from local tools and Claude Desktop. This server lets you explore, test, and deploy MCP-enabled capabilities with a simple local run and a future remote deployment.

How to use

You can interact with your MCP server locally using the MCP Inspector. Start the server, then connect the inspector to its SSE endpoint to list and call defined tools. You can also connect Claude Desktop to your local server to access tools through a familiar desktop workflow.

How to install

Prerequisites you need before installing:
- Node.js and npm (or pnpm) installed on your machine
- Git installed to clone the project
- A terminal or command prompt with access to run commands

# 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

Additional steps for local testing with Claude Desktop

To connect Claude Desktop to your local MCP server, update its configuration to point to your local server’s SSE endpoint. Use the following configuration to route Claude’s MCP calls through a local proxy.

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