MCP Server on Cloudflare Workers

MCP Server on Cloudflare Workers with Bearer Auth

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

Overview

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

Local Development

# Install dependencies npm install # Run the server locally npm run dev

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

Authentication

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.

Testing with MCP Inspector

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

Deploying to Cloudflare

Deploy your MCP server to Cloudflare Workers:

npm run deploy

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

Project Structure

  • 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

Important Notes

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

Troubleshooting

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
-
security - not tested
-
license - not tested
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A proof of concept implementation of Model Context Protocol server running on Cloudflare's edge network with bearer token authentication, allowing deployed AI models to access tools via serverless architecture.

  1. Overview
    1. Local Development
      1. Authentication
        1. Testing with MCP Inspector
          1. Deploying to Cloudflare
            1. Project Structure
              1. Important Notes
                1. Troubleshooting

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server implementation that runs on Cloudflare Workers with OAuth login, allowing Claude and other AI models to access tools via the MCP standard.
                    Last updated -
                    TypeScript
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server implementation that runs on Cloudflare Workers, providing tool integration for AI assistants like Claude with OAuth login capability.
                    Last updated -
                    14
                    TypeScript
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A tool for deploying a remote Model Context Protocol server on Cloudflare Workers without authentication requirements, allowing users to create custom AI tools accessible from Claude Desktop or Cloudflare AI Playground.
                    Last updated -
                    TypeScript
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A deployable Model Context Protocol server on Cloudflare Workers that operates without authentication, allowing connection to AI assistants like Claude Desktop and Cloudflare AI Playground.
                    Last updated -
                    TypeScript

                  View all related MCP servers

                  ID: 40vqylshvd