Remote MCP Server

by peanut996

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 MCP server designed to run on Cloudflare Workers. It enables you to expose MCP tools and functionalities to clients like the MCP Inspector and Claude Desktop, facilitating communication and interaction with large language models.

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 it locally for development and testing. To deploy it to Cloudflare, you need to create a KV namespace, configure wrangler.jsonc, and run the deploy command. Finally, you can connect MCP clients by providing the 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
SSE transport

Use cases of Remote MCP Server

Exposing custom tools to LLMs
Integrating LLMs with external services
Building AI-powered applications
Testing and development of MCP tools
Experimenting with LLM interactions

FAQ from Remote MCP Server

How do I connect the MCP Inspector?

Start the inspector, switch the Transport Type to SSE, and enter the server's URL (e.g., http://localhost:8787/sse or worker-name.account-name.workers.dev/sse).

How do I connect Claude Desktop?

Update the Claude configuration file to point to the server's URL and restart Claude.

What if something goes wrong?

Try restarting Claude or connecting directly to the MCP server on the command line using npx mcp-remote http://localhost:8787/sse. You might also need to clear the files in ~/.mcp-auth.

How do I deploy 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 is MCP?

MCP stands for Model Context Protocol. It's a protocol for connecting LLMs with tools and services.