Remote MCP Server logo

Remote MCP Server

by RomanTCC

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

View on GitHub

Last updated: N/A

What is Remote MCP Server?

This is a remote Model Context Protocol (MCP) server designed to run on Cloudflare Workers. It facilitates communication between MCP clients (like the MCP Inspector or Claude Desktop) and tools, enabling them to interact and exchange information.

How to use Remote MCP Server?

To use this server, you first need to clone the repository and install the dependencies. You can then run the server locally for development and testing. To deploy to Cloudflare, you need to create a KV namespace, add the namespace ID to wrangler.jsonc, and run npm run deploy. Finally, configure your MCP client (e.g., MCP Inspector or Claude Desktop) to point to the deployed server's URL.

Key features of Remote MCP Server

  • Remote MCP server

  • Cloudflare Workers deployment

  • OAuth login

  • MCP Inspector compatibility

  • Claude Desktop integration

Use cases of Remote MCP Server

  • Connecting Claude to custom tools

  • Developing and testing MCP tools remotely

  • Integrating MCP with serverless environments

  • Enabling AI model interaction with external services

  • Extending Claude's capabilities with custom functions

FAQ from Remote MCP Server

How do I connect the MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector. Switch the Transport Type to SSE and enter the server URL (e.g., http://localhost:8787/sse) to connect.

How do I connect Claude Desktop?

Update the Claude configuration file to point to your server's URL (e.g., http://localhost:8787/sse) and restart Claude.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy.

What if something goes wrong?

Try restarting Claude or connecting directly to your MCP server on the command line with npx mcp-remote http://localhost:8787/sse. Clearing the files in ~/.mcp-auth may also help.

What is MCP?

MCP stands for Model Context Protocol. It's a protocol that allows AI models to interact with external tools and services.