Remote

Provides a remote MCP server for Cloudflare Workers with local and remote access via SSE and OAuth-enabled login.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

You can run a remote MCP server on Cloudflare Workers and connect it with MCP clients, enabling browser-based OAuth login, local testing, and remote access from Claude Desktop or other MCP clients.

How to use

You will run the MCP server locally for development or deploy it to Cloudflare. Use the MCP Inspector to connect to your server using Server-Sent Events (SSE). From Claude Desktop, point the MCP configuration to your local or remote server so Claude can call tools exposed by the MCP server.

How to install

Prerequisites you need on your machine: a recent Node.js environment and a package manager. You also need pnpm for dependency management as recommended in the development workflow.

# 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
pnpm install

# run locally
npx nx dev remote-mcp-server

Additional sections

Configuration and testing steps allow you to run the MCP server locally, connect with the MCP Inspector, and link Claude Desktop to either a local or remote server.

Develop locally, connect the inspector, and deploy to Cloudflare as described below. If you are debugging, you can restart Claude or run a direct MCP connection command to verify the server responds.

Configuration and usage notes

Local development server URL: http://localhost:8787/sse for the MCP server. The inspector connects to this endpoint using SSE.

Claude Desktop configuration for local development replaces the file with a JSON block that routes to the local server over SSE.

Troubleshooting and debugging

If you run into issues, you can restart Claude or try connecting directly to the MCP server from the command line to confirm accessibility.

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

If problems persist, you can clear local authentication data to reset sessions.


## Available tools

### inspector

MCP Inspector enables exploring the MCP API, connecting via SSE, logging in with mock credentials, listing and calling tools.