FastMCP Cloudflare Demo

A demonstration of FastMCP running on Cloudflare Workers edge runtime.

Live Demo: https://fastmcp.jordanhburke.com

Features

• Edge Runtime: Runs on Cloudflare Workers V8 isolates
• Stateless MCP: No session persistence - each request is independent
• Zero Node.js Dependencies: Uses only edge-compatible APIs
• Full MCP Support: Tools, Resources, and Prompts
• Custom HTTP Routes: REST API endpoints alongside MCP (Issue #160)

Quick Start

# Install dependencies
pnpm install

# Start local development
pnpm dev

# Deploy to Cloudflare
pnpm deploy

Development Commands

# Code quality
pnpm validate     # format + lint + typecheck
pnpm format       # Format with Prettier
pnpm lint         # Fix ESLint issues
pnpm typecheck    # Check TypeScript types

# Cloudflare Workers
pnpm dev          # Local dev server at http://localhost:8787
pnpm deploy       # Deploy to Cloudflare Workers
pnpm tail         # Stream logs from deployed worker

MCP Features

Tools

Tool	Description
greet	Greet someone by name
echo	Echo back input text
get_datetime	Get current date/time with timezone support

Resources

URI	Description
info://server	Server information (JSON)
info://fastmcp	FastMCP project info (Markdown)

Prompts

Name	Description
analyze_code	Code analysis prompt template

Custom HTTP Routes

FastMCP supports adding custom HTTP routes alongside MCP endpoints via server.getApp():

const app = server.getApp()

app.get("/api/info", (c) => c.json({ name: "My Server" }))
app.get("/api/time", (c) => c.json({ time: new Date().toISOString() }))

Available REST Endpoints

Method	Path	Description
GET	/	Landing page
GET	/health	Health check
GET	/api/info	Server info (JSON)
GET	/api/time	Current time (JSON)

Configuration

Edit wrangler.toml to configure your deployment:

name = "fastmcp-demo"
main = "src/index.ts"
compatibility_date = "2024-11-01"

[[routes]]
pattern = "your-domain.com/*"
zone_name = "your-domain.com"

Testing

# Health check
curl http://localhost:8787/health

# Connect with an MCP client
# SSE endpoint: http://localhost:8787/sse

Tech Stack

• FastMCP - TypeScript MCP framework
• Cloudflare Workers - Edge runtime
• ts-builds - TypeScript toolchain
• Zod - Schema validation

License

MIT