MCP-server

Universal MCP Server

A Universal MCP (Model Context Protocol) Server running on Cloudflare Workers. This server provides various tools including a calculator and a universal API caller that can be used by any MCP client.

Features

• Authless: No authentication required to use the server
• CORS-enabled: Works with browser-based clients
• Session Management: Properly handles MCP sessions
• Tools:
  • add: Simple addition tool
  • calculate: Advanced calculator with multiple operations
  • callApi: Universal API caller for making HTTP requests to any endpoint
  • system.listTools: Lists all available tools

Deployment

This server can be deployed to Cloudflare Workers using GitHub Actions:

1. Fork this repository
2. Add your Cloudflare API Token and Account ID as GitHub secrets:
   • CF_API_TOKEN: Your Cloudflare API token with Workers permissions
   • CF_ACCOUNT_ID: Your Cloudflare account ID
3. Push to the main branch to trigger deployment

Local Development

Standard Method

# Install dependencies
npm install

# Start local development server
npm run dev

Using Docker

This project can also be run in a Docker container:

# Build and start the container
docker-compose up --build

# Or run in detached mode
docker-compose up -d

# Stop the container
docker-compose down

The server will be available at http://localhost:8787

Connect to Cloudflare AI Playground

You can connect to your MCP server from the Cloudflare AI Playground, which is a remote MCP client:

1. Go to https://playground.ai.cloudflare.com/
2. Enter your deployed MCP server URL (remote-mcp-server-authless.<your-account>.workers.dev/sse)
3. You can now use your MCP tools directly from the playground!

Connect Claude Desktop to your MCP server

You can also connect to your remote MCP server from local MCP clients, by using the mcp-remote proxy.

To connect to your MCP server from Claude Desktop, follow Anthropic's Quickstart and within Claude Desktop go to Settings > Developer > Edit Config.

Update with this configuration:

{
  "mcpServers": {
    "calculator": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"  // or remote-mcp-server-authless.your-account.workers.dev/sse
      ]
    }
  }
}

Restart Claude and you should see the tools become available.

MCP-server