what is my-mcp-server?
my-mcp-server is a remote Model Context Protocol (MCP) server that runs on Cloudflare Workers, allowing users to connect and interact with various tools via a web interface.
how to use my-mcp-server?
To use my-mcp-server, clone the repository, install dependencies, and run the server locally. You can then connect to it using the MCP Inspector or integrate it with Claude Desktop for enhanced functionality.
key features of my-mcp-server?
- Easy setup on Cloudflare Workers
- Local development and testing capabilities
- Integration with MCP Inspector for API exploration
- Compatibility with Claude Desktop for advanced tool usage
use cases of my-mcp-server?
- Developing and testing remote APIs using the MCP protocol.
- Connecting AI tools like Claude to perform tasks via the MCP server.
- Deploying a scalable server solution on Cloudflare for remote access.
FAQ from my-mcp-server?
- Can I run my-mcp-server without Cloudflare?
No, my-mcp-server is designed to run on Cloudflare Workers for optimal performance.
- Is there a user authentication feature?
Currently, my-mcp-server does not include authentication, allowing for easy access during development.
- How do I deploy my-mcp-server?
You can deploy it by following the deployment instructions in the repository, which include setting up a KV namespace and running the deploy command.
Remote MCP Server on Cloudflare
Let's get a remote MCP server up-and-running on Cloudflare Workers complete with OAuth login!
Develop locally
# clone the repository
git clone git@github.com:cloudflare/ai.git
# install dependencies
cd ai
npm install
# run locally
npx nx dev remote-mcp-server
You should be able to open http://localhost:8787/ in your browser
Connect the MCP inspector to your server
To explore your new MCP api, you can use the MCP Inspector.
- Start it with
npx @modelcontextprotocol/inspector - Within the inspector, switch the Transport Type to
SSEand enterhttp://localhost:8787/sseas the URL of the MCP server to connect to, and click "Connect" - You will navigate to a (mock) user/password login screen. Input any email and pass to login.
- You should be redirected back to the MCP Inspector and you can now list and call any defined tools!
Connect Claude Desktop to your local MCP server
The MCP inspector is great, but we really want to connect this to Claude! Follow Anthropic's Quickstart and within Claude Desktop go to Settings > Developer > Edit Config to find your configuration file.
Open the file in your text editor and replace it with this configuration:
{
"mcpServers": {
"math": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8787/sse"
]
}
}
}
This will run a local proxy and let Claude talk to your MCP server over HTTP
When you open Claude a browser window should open and allow you to login. You should see the tools available in the bottom right. Given the right prompt Claude should ask to call the tool.
Deploy to Cloudflare
npx wrangler kv namespace create OAUTH_KV- Follow the guidance to add the kv namespace ID to
wrangler.jsonc npm run deploy
Call your newly deployed remote MCP server from a remote MCP client
Just like you did above in "Develop locally", run the MCP inspector:
npx @modelcontextprotocol/inspector@latest
Then enter the workers.dev URL (ex: worker-name.account-name.workers.dev/sse) of your Worker in the inspector as the URL of the MCP server to connect to, and click "Connect".
You've now connected to your MCP server from a remote MCP client.
Connect Claude Desktop to your remote MCP server
Update the Claude configuration file to point to your workers.dev URL (ex: worker-name.account-name.workers.dev/sse) and restart Claude
{
"mcpServers": {
"math": {
"command": "npx",
"args": [
"mcp-remote",
"https://worker-name.account-name.workers.dev/sse"
]
}
}
}
Debugging
Should anything go wrong it can be helpful to restart Claude, or to try connecting directly to your MCP server on the command line with the following command.
npx mcp-remote http://localhost:8787/sse
In some rare cases it may help to clear the files added to ~/.mcp-auth
rm -rf ~/.mcp-auth
