Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: netanelgilad

@netanelgilad

Repository

About Remote MCP Server on Cloudflare

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Remote MCP Server on Cloudflare?

It is a project to get a remote MCP server running on Cloudflare Workers with OAuth login, enabling AI clients to connect over HTTP.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Connect clients via SSE endpoints (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse remotely).

Key features of Remote MCP Server on Cloudflare

Runs MCP server on Cloudflare Workers with SSE transport.
Includes OAuth login flow for user authentication.
Supports local development with hot-reload.
Can be connected via MCP Inspector for testing.
Integrates with Claude Desktop through a local proxy (mcp-remote).

Use cases of Remote MCP Server on Cloudflare

Developing and testing MCP tools locally.
Deploying a remote MCP server accessible over the internet.
Connecting Claude Desktop to a self-hosted remote MCP server.
Using the MCP Inspector to explore and call tools.

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npx nx dev remote-mcp-server in the ai directory. The server will be available at http://localhost:8787/.

How can I test the MCP endpoints locally?

Use the MCP Inspector: start it with npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter http://localhost:8787/sse as the server URL. A mock login screen will appear; input any email/password to connect.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. The server will be available at your workers.dev URL.

How do I connect Claude Desktop to this server?

Update Claude’s config file (mcpServers.math.args) to use npx mcp-remote with the SSE URL (local or remote). Restart Claude. A browser window will open for login.

What should I do if something goes wrong?

Restart Claude, or test the connection directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the cached files with rm -rf ~/.mcp-auth.