Remote MCP Server logo

Remote MCP Server

by SzczepanBEN

This project provides a remote Model Context Protocol (MCP) server that can be deployed on Cloudflare Workers with OAuth login. It allows you to connect MCP clients like the MCP Inspector and Claude Desktop to your 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 enables you to expose tools and functionalities to Language Model clients like Claude, using the Model Context Protocol.

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 deploy it to Cloudflare using npx wrangler kv namespace create OAUTH_KV and npm run deploy. Finally, connect your MCP clients (MCP Inspector or Claude Desktop) by configuring them to point to your deployed server's URL.

Key features of Remote MCP Server

  • Remote MCP server

  • Cloudflare Workers deployment

  • OAuth login

  • Integration with MCP Inspector

  • Integration with Claude Desktop

Use cases of Remote MCP Server

  • Exposing custom tools to LLMs

  • Integrating external services with LLMs

  • Building AI-powered applications with Claude

  • Experimenting with MCP

  • Creating a centralized MCP server for multiple clients

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 your server's URL (e.g., http://localhost:8787/sse) as the URL of the MCP server.

How do I connect Claude Desktop?

Follow Anthropic's Quickstart and update the Claude configuration file to point to your server's URL.

How do I deploy to Cloudflare?

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

How do I debug issues?

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.

What is MCP?

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