Skip to main content
Glama

MCP Server on Cloudflare Workers & Azure Functions

by TedTschopp
GitHub
TypeScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Server on Cloudflare Workers & Azure Functions

A Model Context Protocol (MCP) server that can be deployed to Cloudflare Workers or Azure Functions. This server provides tools, prompts, and resources that can be accessed via the MCP protocol, enabling AI assistants to interact with your deployed services.

Features

  • šŸš€ Deployed on Cloudflare Workers (edge computing)

  • šŸ”§ Example tools: get_time, echo, add

  • šŸŒ HTTP endpoints for health checks and MCP requests

  • šŸ“¦ TypeScript with full type safety

  • šŸ”„ Local development with Wrangler

Prerequisites

  • Node.js 18+ installed

  • A Cloudflare account (free tier works)

  • npm or yarn package manager

Installation

Install dependencies:

npm install

Development

Run the development server locally:

npm run dev

This will start a local Cloudflare Workers environment at http://localhost:8787

Available Endpoints

Health Check

GET http://localhost:8787/health

Returns server status and version information.

MCP Protocol Endpoint

POST http://localhost:8787/mcp Content-Type: application/json { "method": "tools/list" }

Available Capabilities

Tools

The server includes three example tools with change notifications:

  1. get_time: Returns the current server time

  2. echo: Echoes back your message

  3. add: Adds two numbers together

Prompts

The server includes five prompt templates with change notifications:

  1. code_review: Get assistance reviewing code

  2. explain_concept: Get explanations of technical concepts

  3. debug_helper: Get help debugging issues

  4. api_design: Get guidance on API design

  5. refactor_suggestion: Get suggestions for refactoring code

Resource Access

The server provides contextual information through resources:

  1. config://server/info: Server metadata and configuration

  2. config://server/status: Current server status and metrics

  3. docs://mcp/getting-started: Getting started guide

Resources support:

  • Subscriptions: Clients can subscribe to resource changes

  • Templates: Parameterized resources (e.g., log://{level}/{message})

  • Multiple MIME types: JSON and Markdown content

Logging

Configurable logging with support for standard log levels:

  • debug, info, notice, warning, error, critical, alert, emergency

Deployment

Option 1: Cloudflare Workers (Recommended for Edge)

1. Login to Cloudflare

npx wrangler login

2. Deploy to Cloudflare Workers

npm run deploy

Your MCP server will be deployed and you'll receive a URL like: https://mcp-server.<your-subdomain>.workers.dev

Option 2: Azure Functions (Recommended for Azure Ecosystem)

For detailed Azure deployment instructions, see AZURE_DEPLOYMENT.md.

Quick Start

# Install dependencies npm install # Login to Azure az login # Deploy to Azure Functions npm run deploy:azure

Your MCP server will be available at: https://<your-function-app>.azurewebsites.net

Testing Deployed Server

# Health check curl https://mcp-server.<your-subdomain>.workers.dev/health # Test MCP endpoint curl -X POST https://mcp-server.<your-subdomain>.workers.dev/mcp \ -H "Content-Type: application/json" \ -d '{"method": "tools/list"}'

Project Structure

. ā”œā”€ā”€ src/ ā”‚ ā””ā”€ā”€ index.ts # Main server implementation ā”œā”€ā”€ .github/ ā”‚ ā””ā”€ā”€ copilot-instructions.md ā”œā”€ā”€ package.json # Dependencies and scripts ā”œā”€ā”€ tsconfig.json # TypeScript configuration ā”œā”€ā”€ wrangler.toml # Cloudflare Workers config ā””ā”€ā”€ README.md # This file

Adding New Tools

To add a new tool, edit src/index.ts:

  1. Add tool definition in ListToolsRequestSchema handler

  2. Add tool implementation in CallToolRequestSchema handler

Example:

// In ListToolsRequestSchema handler { name: 'my_tool', description: 'Description of what it does', inputSchema: { type: 'object', properties: { param1: { type: 'string', description: 'Parameter description', }, }, required: ['param1'], }, } // In CallToolRequestSchema handler case 'my_tool': return { content: [ { type: 'text', text: `Result: ${args.param1}`, }, ], };

Configuration

Cloudflare Workers Settings

Edit wrangler.toml to configure:

  • Worker name

  • Compatibility date

  • KV namespaces (for storage)

  • D1 databases (for SQL)

  • Environment variables

Troubleshooting

Build Errors

Check TypeScript types:

npm run types

Deployment Issues

View deployment logs:

npx wrangler tail

Resources

License

MIT

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

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 deployable MCP server for Cloudflare Workers or Azure Functions that provides example tools (time, echo, math), prompt templates for code assistance, and configuration resources. Enables AI assistants to interact with edge-deployed services through the Model Context Protocol.

  1. Features
    1. Prerequisites
      1. Installation
        1. Development
          1. Available Endpoints
            1. Health Check
            2. MCP Protocol Endpoint
            3. Available Capabilities
          2. Deployment
            1. Option 1: Cloudflare Workers (Recommended for Edge)
            2. Option 2: Azure Functions (Recommended for Azure Ecosystem)
          3. Testing Deployed Server
            1. Project Structure
              1. Adding New Tools
                1. Configuration
                  1. Cloudflare Workers Settings
                2. Troubleshooting
                  1. Build Errors
                  2. Deployment Issues
                3. Resources
                  1. License

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/TedTschopp/MCP-Server-on-CloudFlare'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server