MCP Nexus Cloudflare

MCP Nexus-Cloudflare员工


一键将MCP Nexus部署到Cloudflare的免费层。这为Tavily和Brave Search API提供了一个统一的MCP服务器，并自动轮换API密钥。

特性

• 零成本托管 Cloudflare Workers免费版
• D1数据库 用于持久存储（自动配置）
• 加密的API密钥 使用Web Crypto API
• 包括管理UI -用于管理密钥和令牌的完整web界面
• 7个MCP工具：数据搜索、数据提取、数据抓取、数据地图、数据研究、勇敢搜索、勇敢搜索

部署

选项1：一键部署

单击上面的按钮并按照提示进行操作。您将被要求：

1. 授权Cloudflare访问您的GitHub（将创建分叉）
2. 配置机密：

- ADMIN_API_TOKEN：管理员API访问的令牌（使用生成 openssl rand -hex 32) - KEY_ENCRYPTION_SECRET：用于加密API密钥的密钥（使用生成 openssl rand -base64 32)

选项2：手动部署

# Clone the repo
git clone https://github.com/ykq007/mcp-nexus.git
cd mcp-nexus/packages/worker

# Install dependencies
npm install

# Create D1 database
npx wrangler d1 create mcp-nexus-db
# Copy the database_id from output to wrangler.jsonc

# Set secrets
npx wrangler secret put ADMIN_API_TOKEN
npx wrangler secret put KEY_ENCRYPTION_SECRET

# Run migrations and deploy
npm run deploy

部署后设置

部署之后，您需要添加API密钥并创建客户端令牌。

1.添加Tavilly API密钥

curl -X POST https://your-worker.workers.dev/admin/api/tavily-keys \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label": "Primary Key", "key": "tvly-xxxxx"}'

2.添加勇敢的API密钥（可选）

curl -X POST https://your-worker.workers.dev/admin/api/brave-keys \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label": "Primary Key", "key": "BSAxxxxx"}'

3.创建客户端令牌

curl -X POST https://your-worker.workers.dev/admin/api/tokens \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description": "Claude Desktop"}'

保存返回的 token -它只显示一次。

MCP客户端配置

克劳德桌面/克莱恩

{
  "mcpServers": {
    "mcp-nexus": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-proxy", "https://your-worker.workers.dev/mcp"],
      "env": {
        "MCP_HEADERS": "Authorization: Bearer YOUR_CLIENT_TOKEN"
      }
    }
  }
}

直接HTTP

curl -X POST https://your-worker.workers.dev/mcp \
  -H "Authorization: Bearer YOUR_CLIENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }'

API终点

本地开发

# Install dependencies
npm install

# Create local D1 database
npm run db:migrate:local

# Start dev server
npm run dev

建筑

┌─────────────────────────────────────────────────────────┐
│                  Cloudflare Workers                      │
├─────────────────────────────────────────────────────────┤
│  Hono Router                                            │
│  ├── /mcp (MCP JSON-RPC)                               │
│  ├── /admin/api/* (Admin API)                          │
│  └── /health                                           │
├─────────────────────────────────────────────────────────┤
│  Services                                               │
│  ├── Key Pool (rotation, cooldown)                     │
│  ├── Tavily Client                                     │
│  └── Brave Client                                      │
├─────────────────────────────────────────────────────────┤
│  D1 Database                                           │
│  ├── tavily_keys (encrypted)                           │
│  ├── brave_keys (encrypted)                            │
│  ├── client_tokens (hashed)                            │
│  ├── server_settings                                   │
│  └── usage_logs                                        │
└─────────────────────────────────────────────────────────┘

许可证

麻省理工学院