Remote MCP Server
by imsardine
This project provides a remote Model Context Protocol (MCP) server that can be deployed on Cloudflare Workers. It enables connecting MCP clients like the MCP Inspector and Claude Desktop to a server running remotely.
Last updated: N/A
What is Remote MCP Server?
This is a remote MCP server implementation designed to run on Cloudflare Workers. It allows you to expose MCP tools and functionalities over a network, enabling remote clients to interact with them.
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, update the wrangler.jsonc file with the namespace ID, and then run the deploy command. Finally, configure your MCP client (e.g., MCP Inspector or Claude Desktop) to connect to the deployed server's URL.
Key features of Remote MCP Server
Remote access to MCP tools
Cloudflare Workers deployment
OAuth login
Integration with MCP Inspector
Integration with Claude Desktop
Use cases of Remote MCP Server
Exposing AI tools to remote applications
Integrating AI models with Claude
Building distributed AI systems
Testing and debugging MCP implementations
Providing a centralized MCP server for multiple clients
FAQ from Remote MCP Server
How do I connect the MCP Inspector to the server?
How do I connect the MCP Inspector to the server?
Start the MCP Inspector, switch the Transport Type to SSE, and enter the server's URL (e.g., http://localhost:8787/sse for local development or worker-name.account-name.workers.dev/sse for deployed server) as the URL of the MCP server to connect to.
How do I connect Claude Desktop to the server?
How do I connect Claude Desktop to the server?
Update the Claude configuration file to point to the server's URL and restart Claude. The configuration file is usually located in Settings > Developer > Edit Config within Claude Desktop.
How do I deploy the server to Cloudflare?
How do I deploy the server to Cloudflare?
Create a KV namespace using npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and then run npm run deploy.
What do I do if something goes wrong?
What do I do if something goes wrong?
Try restarting Claude, or connecting directly to your MCP server on the command line with the command npx mcp-remote http://localhost:8787/sse. In some rare cases, clearing the files added to ~/.mcp-auth may help.
What is MCP?
What is MCP?
MCP stands for Model Context Protocol. It's a protocol that allows AI models to interact with tools and services to perform tasks.