Remote MCP Server

by irvinebroque

AI/Development Tools Cloudflare Workers OAuth Serverless Claude

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?

A remote MCP server implemented on Cloudflare Workers, enabling access to tools and functionalities through the Model Context Protocol.

How to use Remote MCP Server?

The server can be developed locally using npm run dev remote-mcp-server. It can be deployed to Cloudflare using npm run deploy after setting up a KV namespace. Once deployed, you can connect to it using the MCP Inspector or Claude Desktop by configuring the appropriate 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

Connecting Claude to remote tools
Exposing MCP tools as a service
Building AI-powered applications
Extending Claude's capabilities
Experimenting with Model Context Protocol

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 the inspector with npx @modelcontextprotocol/inspector, switch the Transport Type to SSE, and enter the server URL (e.g., http://localhost:8787/sse).

How do I connect Claude Desktop?

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

How do I deploy to Cloudflare?

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

What should I do if something goes wrong?

Try restarting Claude or connecting directly to your MCP server using npx mcp-remote http://localhost:8787/sse. You can also try clearing the files added to ~/.mcp-auth.