Remote MCP Server on Cloudflare
About
A remote MCP server deployable on Cloudflare Workers with OAuth login support.
Details
- Author
- jakepartusch
- Downloads
- 248
- Categories
- Cloud Service, Infrastructure, Other
- Tags
- #cloudflare
Jump to
- Deploy a remote MCP server on Cloudflare Workers.
- Built-in OAuth login for secure access.
- Uses SSE (Server-Sent Events) transport.
- Supports connection from MCP Inspector and Claude Desktop.
- Includes a local development workflow with mock login.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Remote MCP Server on CloudflareCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"remote mcp server on cloudflare": {
"remote-mcp-server-2-jakepartusch": {
"command": "npx",
"args": [
"nx",
"dev",
"remote-mcp-server"
]
}
}
}
}McpServers
{
"remote-mcp-server-2-jakepartusch": {
"command": "npx",
"args": [
"nx",
"dev",
"remote-mcp-server"
]
}
}A remote MCP server deployable on Cloudflare Workers with 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 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 openhttp://localhost:8787/in your browser
Connect the MCP inspector to your server
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!
Connect Claude Desktop to your local MCP server
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.
Open the file in your text editor and replace it with this configuration:
{ "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 self-hostable MCP server for deployment on Cloudflare Workers using Durable Objects.
Deploy a remote, authentication-free MCP server on Cloudflare Workers.
Deploy a remote, authentication-free MCP server on Cloudflare Workers.
Multi-cloud deployment MCP server — deploy to Cloudflare Pages, Vercel, or Netlify from a single tool with 26 MCP tools.
The remote MCP bridge that lets any AI agent deploy, manage, and scale applications to Cloudflare, Netlify, or Vercel.
A remote, auth-less MCP server deployable on Cloudflare Workers or locally via npm.
A remote MCP server deployable on Cloudflare Workers with OAuth login support.
Core AWS MCP server providing prompt understanding and server management capabilities.
An MCP service for deploying HTML content to EdgeOne Pages and obtaining a publicly accessible URL.
Create, build, deploy, and manage Netlify resources using natural language.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
