Remote MCP Server on Cloudflare

An MCP server deployed on Cloudflare Workers, featuring OAuth login support.

Let's get a remote MCP server up-and-running on Cloudflare Workers complete with OAuth login!

# 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

You should be able to openhttp://localhost:8787/in your browser

To explore your new MCP api, you can use theMCP Inspector.

- Start it withnpx @modelcontextprotocol/inspector
- Within the inspector, switch the Transport Type toSSEand enterhttp://localhost:8787/sseas the URL of the MCP server to connect to, and click "Connect"
- You will navigate to a (mock) user/password login screen. Input any email and pass to login.
- You should be redirected back to the MCP Inspector and you can now list and call any defined tools!

The MCP inspector is great, but we really want to connect this to Claude! FollowAnthropic's Quickstartand within Claude Desktop go to Settings > Developer > Edit Config to find your configuration file.

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

This will run a local proxy and let Claude talk to your MCP server over HTTP

When you open Claude a browser window should open and allow you to login. You should see the tools available in the bottom right. Given the right prompt Claude should ask to call the tool.
- npx wrangler kv namespace create OAUTH_KV
- Follow the guidance to add the kv namespace ID towrangler.jsonc
- npm run deploy

Call your newly deployed remote MCP server from a remote MCP client

Just like you did above in "Develop locally", run the MCP inspector:

npx @modelcontextprotocol/inspector@latest

Then enter theworkers.devURL (ex:worker-name.account-name.workers.dev/sse) of your Worker in the inspector as the URL of the MCP server to connect to, and click "Connect".

You've now connected to your MCP server from a remote MCP client.

Connect Claude Desktop to your remote MCP server

Update the Claude configuration file to point to yourworkers.devURL (ex:worker-name.account-name.workers.dev/sse) and restart Claude

{ "mcpServers": { "math": { "command": "npx", "args": [ "mcp-remote", "https://worker-name.account-name.workers.dev/sse" ] } } }

Should anything go wrong it can be helpful to restart Claude, or to try connecting directly to your MCP server on the command line with the following command.

npx mcp-remote http://localhost:8787/sse

In some rare cases it may help to clear the files added to~/.mcp-auth

A production-ready MCP server on Cloudflare Workers with GitHub OAuth and Fantasy Premier League integration.

A self-hostable MCP server for Cloudflare Workers with OAuth login support, using Cloudflare KV for storage.

An MCP server designed to run on Cloudflare Workers, featuring OAuth login support.

A remote MCP server that runs on Cloudflare Workers and supports OAuth login.

A remote MCP server running on Cloudflare Workers with OAuth login support.

A remote MCP server deployable on Cloudflare Workers with OAuth login support, using Cloudflare KV for data storage.

A remote MCP server deployable on Cloudflare Workers with OAuth login support, using Cloudflare KV for data storage.

A remote MCP server deployable on Cloudflare Workers with OAuth login support, using Cloudflare KV for data storage.

A remote MCP server running on Cloudflare Workers with OAuth login support.

A remote MCP server deployable on Cloudflare Workers with OAuth login support for both local development and remote deployment.