MCP-Server-on-CloudFlare by TedTschopp - MCP Server

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:

get_time: Returns the current server time
echo: Echoes back your message
add: Adds two numbers together

Prompts

The server includes five prompt templates with change notifications:

code_review: Get assistance reviewing code
explain_concept: Get explanations of technical concepts
debug_helper: Get help debugging issues
api_design: Get guidance on API design
refactor_suggestion: Get suggestions for refactoring code

Resource Access

The server provides contextual information through resources:

config://server/info: Server metadata and configuration
config://server/status: Current server status and metrics
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 .

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:

Add tool definition in ListToolsRequestSchema handler
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