feat: Add dual-platform support (Workers + Pages) and project cleanup
A high-performance MCP (Model Context Protocol) server running on Cloudflare Workers/Pages edge computing platforms.
- 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 calculatorsearxng_web_search- Web search via SearXNGweb_url_read- Fetch and read URL contentsequentialthinking- Structured problem-solving tool
npm install
# Cloudflare Workers (recommended)
npm run dev
# Or Cloudflare Pages
npm run dev:pages
Open http://localhost:8787 in your browser to see the dashboard.
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.
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"worker-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8787/mcp"]
}
}
}
npm run deploy
npm run deploy:pages
| Variable | Required | Description |
|---|---|---|
API_KEY | No | API key for MCP endpoint authentication |
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
| Endpoint | Method | Description |
|---|---|---|
/ | GET | Web dashboard |
/mcp | POST | MCP JSON-RPC 2.0 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
rm -rf ~/.mcp-auth
npx wrangler tail
MIT
About
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
