Remote

Provides a remote MCP server accessible via SSE over HTTP, with local development and Cloudflare deployment options.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks 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 that exposes a standard MCP API locally or remotely, with an easy path for OAuth login and integration with clients like the MCP Inspector and Claude Desktop.

How to use

Start your local MCP server and connect with the MCP Inspector to explore available tools and test calls. You can also connect Claude Desktop to your local server to run tools in a graphical environment.

To explore locally: start the MCP server and connect the inspector via SSE at the provided URL. You will see a mock login screen where you can enter any email and password to proceed, then you can list and call defined tools.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine. You may also need npx for running short-lived binaries.

Clone the project repository to your development machine.
Install dependencies for the project.
Run the MCP server in development mode to serve locally on port 8787.
Deploy the server to Cloudflare Workers and set up necessary Cloudflare KV namespaces for OAuth.

Additional sections

Configure your local development to connect Claude Desktop to your MCP server by editing the suitable configuration file for Claude. You will replace the default MCP server entry with a path to your local server, so Claude can proxy requests to your MCC server over HTTP.

To debug or iterate quickly, you can test the game plan from the command line and reset authentication data if you run into authorization issues.

If you need to reset local authentication state, you can remove the local MCP auth cache directory.

Deploying to Cloudflare and connecting from remote clients

Prepare a Cloudflare KV namespace for OAuth data and deploy the server so it is accessible as a remote MCP server from clients.

After deployment, connect MCP clients to the remote server using the remote Worker URL and the SSE endpoint.

Debugging

If you encounter issues, restart the Claude client or connect directly from the command line to your MCP server for quick checks.

You can also test the remote MCP server directly from the command line to verify the SSE endpoint is responding.