Remote MCP Server logo

Remote MCP Server

by danXyu

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

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 tools and functionalities to AI models like Claude through the Model Context Protocol.

How to use Remote MCP Server?

To use this server, you need to clone the repository, install dependencies, and run it locally or deploy it to Cloudflare. You can then connect to it using the MCP Inspector or configure Claude Desktop to utilize the server's tools.

Key features of Remote MCP Server

  • Remote access to 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 AI models

  • Enabling AI models to interact with external services

  • Building AI-powered applications with custom functionalities

  • Testing and debugging MCP integrations

  • Extending the capabilities of AI models like Claude

FAQ from Remote MCP Server

How do I connect to the server locally?

Run npx nx dev remote-mcp-server and open http://localhost:8787/ in your browser.

How do I connect the MCP inspector?

Start it with npx @modelcontextprotocol/inspector, switch the Transport Type to SSE and enter http://localhost:8787/sse as the URL.

How do I deploy to Cloudflare?

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

How do I connect Claude Desktop to the server?

Update the Claude configuration file to point to your server's URL (either local or deployed) and restart Claude.

What do 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. You can also clear the files added to ~/.mcp-auth.