Remote MCP Server on Cloudflare

by basehub-ai

1 176 downloads Not rated yet
GitHub

About

# Remote MCP Server on Cloudflare Let's get a remote MCP server up-and-running on Cloudflare Workers complete with OAuth login! ## Develop locally ```bash # clone the repository git clone [email protected]:cloudflare/ai.git # install dependencies cd ai npm install # run locally npx nx dev remote-mcp-server ``` You should…

Explore

- Runs MCP server on Cloudflare Workers.
- OAuth login for secure access.
- SSE transport for real‑time tool calls.
- Compatible with MCP Inspector and Claude Desktop.
- Local development workflow with hot reload.
- One‑command deployment via Wrangler.

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Remote MCP Server on Cloudflare
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

cd ai
npm install

1. npx wrangler kv namespace create OAUTH_KV
2. Follow the guidance to add the kv namespace ID to wrangler.jsonc
3. npm run deploy

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

npx @modelcontextprotocol/inspector@latest

Then enter the workers.dev URL (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": {
            "example-remote-mcp-server": {
                "command": "npx",
                "args": [
                    "nx",
                    "dev",
                    "remote-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "example-remote-mcp-server": {
        "command": "npx",
        "args": [
            "nx",
            "dev",
            "remote-mcp-server"
        ]
    }
}

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

Develop locally

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.