Remote MCP Server logo

Remote MCP Server

by leo-guinan

This project provides a remote Model Context Protocol (MCP) server that can be deployed on Cloudflare Workers. It allows you to connect MCP clients like the MCP Inspector and Claude Desktop to your server for tool execution.

View on GitHub

Last updated: N/A

What is Remote MCP Server?

This is a remote MCP server implementation designed to run on Cloudflare Workers. It enables you to expose and interact with tools defined using the Model Context Protocol (MCP) from remote clients.

How to use Remote MCP Server?

  1. Develop locally using npm run dev remote-mcp-server. 2. Connect the MCP Inspector by setting the Transport Type to SSE and the URL to http://localhost:8787/sse. 3. Connect Claude Desktop by updating the configuration file to point to the local or deployed server URL. 4. Deploy to Cloudflare using npm run deploy. 5. Connect remote clients like the MCP Inspector or Claude Desktop by pointing them to the deployed Cloudflare Workers URL.

Key features of Remote MCP Server

  • Remote MCP server

  • Cloudflare Workers deployment

  • OAuth login

  • SSE transport

  • Integration with MCP Inspector

  • Integration with Claude Desktop

Use cases of Remote MCP Server

  • Exposing tools to Claude

  • Remote tool execution

  • Centralized tool management

  • Serverless MCP infrastructure

  • Testing MCP tools

FAQ from Remote MCP Server

How do I run the server locally?

Use the command npx nx dev remote-mcp-server after installing dependencies.

How do I connect the MCP Inspector?

Set the Transport Type to SSE and the URL to http://localhost:8787/sse (for local) or your deployed Workers URL.

How do I connect Claude Desktop?

Update the Claude configuration file to point to your local or deployed server URL.

How do I deploy to Cloudflare?

Create a KV namespace, add the ID to wrangler.jsonc, and run npm run deploy.

What do I do if something goes wrong?

Try restarting Claude, connecting directly to the server with npx mcp-remote, or clearing the files in ~/.mcp-auth.