Skip to main content
Glama

worker-mcp

A high-performance MCP (Model Context Protocol) server running on Cloudflare Workers/Pages edge computing platforms.

Features

  • Web Dashboard - Visual interface to browse and test MCP tools

  • MCP Protocol - Full JSON-RPC 2.0 support over HTTP/SSE

  • Built-in Tools:

    • add - Simple addition calculator

    • searxng_web_search - Web search via SearXNG

    • web_url_read - Fetch and read URL content

    • sequentialthinking - Structured problem-solving tool

Related MCP server: Remote MCP Server

Getting Started

Install Dependencies

npm install

Local Development

# Cloudflare Workers (recommended)
npm run dev

# Or Cloudflare Pages
npm run dev:pages

Open http://localhost:8787 in your browser to see the dashboard.

Connect MCP Inspector

Use MCP Inspector to test your server:

npx @modelcontextprotocol/inspector

Configure the inspector:

  • Transport Type: SSE

  • URL: http://localhost:8787/mcp

After connecting, you should see your available tools and be able to call them.

Connect to Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "worker-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8787/mcp"]
    }
  }
}

Deployment

npm run deploy

Cloudflare Pages

npm run deploy:pages

Environment Variables

Variable

Required

Description

API_KEY

No

API key for MCP endpoint authentication

Project Structure

worker-mcp/
├── src/
│   ├── index.ts        # Workers entry point
│   ├── app.ts          # Hono web app (dashboard)
│   ├── server.ts       # MCP request handler
│   └── tools/          # MCP tool implementations
│       ├── index.ts
│       ├── add.ts
│       ├── web-search.ts
│       ├── web-url-read.ts
│       └── sequentialthinking.ts
├── pages/
│   ├── _worker.ts      # Pages Functions entry point
│   └── _routes.json    # Pages routing config
├── static/             # Static assets (dashboard UI)
├── wrangler.jsonc      # Workers configuration
├── package.json
└── biome.json          # Code formatting/linting

API Endpoint

Endpoint

Method

Description

/

GET

Web dashboard

/mcp

POST

MCP JSON-RPC 2.0 endpoint

MCP Endpoint

URL: https://your-worker.workers.dev/mcp

Authentication (if API_KEY is set):

# Via header
curl -H "Authorization: Bearer YOUR_API_KEY" https://your-worker.workers.dev/mcp

# Or via query parameter
curl https://your-worker.workers.dev/mcp?apiKey=YOUR_API_KEY

Troubleshooting

Clear MCP auth cache

rm -rf ~/.mcp-auth

Check logs

npx wrangler tail

License

MIT

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NuerSir/mcp-server-worker'

If you have feedback or need assistance with the MCP directory API, please join our Discord server