Remote MCP Server logo

Remote MCP Server

by omaree14

This project provides a remote MCP (Model Context Protocol) server that can be deployed on Cloudflare Workers. It allows you to connect to the server using the MCP Inspector or Claude Desktop for interacting with defined tools.

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 enables you to expose and interact with tools through the MCP protocol, allowing clients like the MCP Inspector and Claude to utilize them.

How to use Remote MCP Server?

To use this server, you first develop it locally using npm install and npx nx dev remote-mcp-server. Then, you can connect to it using the MCP Inspector by setting the transport type to SSE and providing the server URL. For Claude integration, you need to update the Claude configuration file to point to the server's URL. Finally, you can deploy it to Cloudflare using npm run deploy after creating a KV namespace.

Key features of Remote MCP Server

  • Remote MCP server deployment

  • Cloudflare Workers compatibility

  • OAuth login

  • MCP Inspector integration

  • Claude Desktop integration

  • SSE transport

Use cases of Remote MCP Server

  • Exposing custom tools to LLMs

  • Integrating with Claude for advanced functionality

  • Building serverless AI applications

  • Creating a remote interface for AI models

  • Testing and debugging MCP implementations

FAQ from Remote MCP Server

How do I connect the MCP Inspector to my local server?

Start the MCP Inspector with npx @modelcontextprotocol/inspector. Switch the Transport Type to SSE and enter http://localhost:8787/sse as the URL.

How do I connect Claude Desktop to my local MCP server?

Follow Anthropic's Quickstart and update the Claude configuration file to point to http://localhost:8787/sse.

How do I deploy the server to Cloudflare?

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

How do I connect to my deployed server?

Use the MCP Inspector and enter the workers.dev URL of your Worker as the URL of the MCP server.

What should I do 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. In rare cases, clearing the files in ~/.mcp-auth may help.