🚀 Cloudflare MCP Server

A production-ready Model Context Protocol (MCP) server built on Cloudflare Workers, exposing 20+ tools that can be consumed by Claude Desktop, MCP Inspector, and future ChatGPT MCP support.

🧠 What is MCP?

Model Context Protocol (MCP) allows AI models (like Claude or ChatGPT) to:

• Discover tools dynamically
• Call tools via structured schemas
• Interact with external systems in a standardized way

This server implements the official MCP specification and exposes reusable utility tools.

✨ Features

• 🌐 Remote MCP server (Cloudflare Workers)
• 🧰 20+ tools (Math, Text, Time, Dev utilities)
• 📜 JSON-RPC 2.0 compliant
• ⚡ Serverless & scalable
• 🔍 Verified using MCP Inspector
• 🤖 Claude Desktop compatible
• 🔮 ChatGPT MCP-ready (when rollout enables UI)

🏗️ Project Structure

mcp-cloudflare/
├── src/
│   ├── index.js          # MCP server entry point
│   └── tools/
│       ├── index.js      # Tool registry
│       ├── math.js       # Math tools
│       ├── text.js       # Text tools
│       ├── time.js       # Time tools
│       └── dev.js        # Dev/utility tools
│
├── wrangler.jsonc        # Cloudflare Worker config
├── package.json
└── README.md

🚀 Quick Start

Prerequisites

• Node.js 16+ installed
• Cloudflare account
• Wrangler CLI installed globally

Installation

# Clone the repository
git clone https://github.com/yashbhadale-20/Cloudflare-based-MCP-server
cd mcp-cloudflare-server_tools

# Install dependencies
npm install

# Login to Cloudflare
wrangler login

Local Development

# Start local dev server
npm run dev

# Test the server (in another terminal)
curl -X POST http://localhost:8787 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

Deploy to Cloudflare

# Deploy to production
npm run deploy

# Your server will be available at:
#  https://mcp-cloudflare30.yashbhadale01.workers.dev

🔄 How It Works

1️⃣ MCP Server Initialization

When a client connects, it sends an initialize request:

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "clientInfo": {
      "name": "example-client",
      "version": "1.0.0"
    }
  },
  "id": 1
}

The server responds with:

{
  "jsonrpc": "2.0",
  "result": {
    "protocolVersion": "2024-11-05",
    "serverInfo": {
      "name": "cloudflare-mcp-server",
      "version": "1.0.0"
    },
    "capabilities": {
      "tools": {}
    }
  },
  "id": 1
}

2️⃣ Tool Discovery

Client requests available tools:

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 2
}

Server returns tool definitions:

{
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "add",
        "description": "Add two numbers",
        "inputSchema": {
          "type": "object",
          "properties": {
            "a": { "type": "number" },
            "b": { "type": "number" }
          },
          "required": ["a", "b"]
        }
      }
    ]
  },
  "id": 2
}

3️⃣ Tool Execution

Client calls a tool:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "add",
    "arguments": {
      "a": 5,
      "b": 7
    }
  },
  "id": 3
}

Server executes and responds:

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "12"
      }
    ]
  },
  "id": 3
}

🧰 Available Tools

Math Tools

• add - Add two numbers
• subtract - Subtract two numbers
• multiply - Multiply two numbers
• divide - Divide two numbers

Text Tools

• uppercase - Convert text to uppercase
• lowercase - Convert text to lowercase
• reverse_text - Reverse a string
• word_count - Count words in text
• char_count - Count characters in text

Time Tools

• current_time - Get current time
• current_date - Get current date
• unix_timestamp - Get Unix timestamp
• timezone_ist - Get IST time

Dev/Utility Tools

• random_number - Generate random number
• generate_uuid - Generate UUID v4
• json_pretty - Pretty-print JSON
• base64_encode - Encode to Base64
• base64_decode - Decode from Base64
• hash_string - Hash string with SHA-256
• validate_email - Validate email format

🔍 Testing with MCP Inspector

Verify your server using the official MCP Inspector:

# Install and run inspector
npx @modelcontextprotocol/inspector@latest  https://mcp-cloudflare30.yashbhadale01.workers.dev

# Or for local testing
npx @modelcontextprotocol/inspector@latest http://localhost:8787

The inspector will verify:

• ✅ initialize handshake
• ✅ tools/list discovery
• ✅ tools/call execution
• ✅ JSON-RPC compliance
• ✅ Schema validation

🤖 Client Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cloudflare-mcp": {
      "transport": "http",
      "url": "https://<your-worker>.workers.dev"
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop, and the tools will be available automatically.

ChatGPT (Future)

When ChatGPT enables MCP UI:

1. Open ChatGPT settings
2. Add MCP server URL
3. Tools auto-discover
4. No server changes required

📁 Configuration

wrangler.jsonc

{
  "name": "mcp-cloudflare-server",
  "main": "src/index.js",
  "compatibility_date": "2024-01-01",
  "node_compat": true
}

package.json

{
  "name": "mcp-cloudflare-server",
  "version": "1.0.0",
  "scripts": {
    "dev": "wrangler dev",
    "deploy": "wrangler deploy"
  },
  "devDependencies": {
    "wrangler": "^3.0.0"
  }
}

🛡️ Security Considerations

This is a public MCP server with no authentication by default. For production use, consider:

Adding API Key Authentication

// In src/index.js
const API_KEY = env.API_KEY; // Store in Cloudflare secrets

if (request.headers.get('Authorization') !== `Bearer ${API_KEY}`) {
  return new Response('Unauthorized', { status: 401 });
}

Rate Limiting

// Using Cloudflare Rate Limiting
// Configure in wrangler.jsonc or via dashboard

CORS Configuration

const corsHeaders = {
  'Access-Control-Allow-Origin': 'https://claude.ai',
  'Access-Control-Allow-Methods': 'POST, OPTIONS',
  'Access-Control-Allow-Headers': 'Content-Type',
};

🚀 Future Enhancements

• 🤖 AI-powered tools (OpenAI/Claude integration)
• 🔐 Authentication & API keys
• ☁️ Database-backed tools (KV/D1)
• 📊 Logging & monitoring (Logpush)
• 🔄 Webhooks & async tools
• 📦 MCP template repository
• 🧪 Comprehensive test suite

🐛 Troubleshooting

"Tools not showing in Claude Desktop"

1. Verify config file path
2. Restart Claude Desktop completely
3. Check server is accessible: curl https://mcp-cloudflare30.yashbhadale01.workers.dev
4. Verify JSON syntax in config

"CORS errors"

Add proper CORS headers in src/index.js

"Invalid JSON-RPC response"

Ensure all responses follow JSON-RPC 2.0 format with jsonrpc, result/error, and id fields

📚 Resources

• MCP Specification
• Cloudflare Workers Docs
• JSON-RPC 2.0 Spec
• MCP Inspector

👨‍💻 Author

Yash Bhadale

Built as a hands-on implementation of Model Context Protocol using Cloudflare Workers.

⭐ Why This Project Matters

This repository demonstrates:

• ✅ Real MCP protocol implementation
• ✅ Cloud-native AI tooling
• ✅ Production-grade architecture
• ✅ Future-ready AI integration
• ✅ Serverless best practices

If you're learning MCP — this is a complete reference implementation.

📄 License

MIT License - feel free to use this in your own projects!

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

---

⭐ If this project helped you, please star the repository!