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 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:
- Add tool definition in
ListToolsRequestSchemahandler - Add tool implementation in
CallToolRequestSchemahandler
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