This repository demonstrates a proof of concept implementation of a Model Context Protocol (MCP) server running on Cloudflare Workers with simple bearer token authentication.

This project shows how to:

• Deploy an MCP server on Cloudflare's edge network
• Implement basic bearer token authentication
• Create and expose MCP tools via a serverless architecture

# Install dependencies
npm install

# Run the server locally
npm run dev

After starting the server, it will be available at http://localhost:8787

This implementation uses a simple bearer token authentication scheme. Clients must provide an Authorization header with their requests. The server passes this token to the MCP tools, allowing tools to perform actions based on the authenticated user.

You can use the MCP Inspector to test your MCP server:

1. Install and start the inspector:

   npx @modelcontextprotocol/inspector

2. Configure the inspector:

   • Switch the Transport Type to SSE
   • Enter the URL of your MCP server (local: http://localhost:8787/sse or deployed: https://your-worker.workers.dev/sse)
   • Add a bearer token in the Authorization field
   • Click "Connect"

3. Test the functionality:

   • Click "List Tools" to see available tools
   • Try running the "getToken" tool, which will return your authorization header
   • Try the "add" tool with two numbers to test basic functionality

Deploy your MCP server to Cloudflare Workers:

npm run deploy

After deployment, your server will be available at https://your-worker.workers.dev

• src/index.ts - Main server implementation with MCP tools definition
• src/utils.ts - Helper utilities for rendering the web interface
• wrangler.jsonc - Cloudflare Workers configuration

This is a proof of concept implementation meant to demonstrate how MCP can run in a serverless environment. In a production setting, you would want to implement:

• More robust authentication (OAuth, token validation, etc.)
• Rate limiting and additional security measures
• Proper error handling and monitoring

If you encounter issues:

1. Make sure your bearer token is properly formatted in the Authorization header
2. Check the worker logs in the Cloudflare dashboard
3. Try restarting your local development server

For persistent authentication issues, you may need to clear any cached credentials:

rm -rf ~/.mcp-auth