MuiRouter

Model Context Protocol (MCP) 路由与网关

MCP 路由与多 Server 聚合接入指南

MuiRouter 运行高性能 streamable-HTTP MCP 服务器与路由器。Claude Desktop、Claude Code、Cursor、Cline 等 AI 客户端可直接接入，统一路由大模型、聚合本地与远程多个 MCP Server，并使用同一个 API Key 调度账户工具与生图能力。

1. 双 Era 协议规范支持
全面支持最新的 2026-07-28 无状态 streamable-HTTP 规范，同时向下兼容 2025-11-25 / 2025-06-18 传统客户端握手。

Modern 规范 (2026-07-28)：无状态 streamable-HTTP、显式 _meta 与 Headers（MCP-Protocol-Version）校验、server/discover 动态发现及 DNS rebinding 防护。

Legacy 兼容 (2025-11-25 / 2025-06-18)：支持 initialize 握手协议，保障旧版客户端平滑无缝接入。

2. 服务器端点与鉴权
所有 MCP 客户端均连接同一个 streamable-HTTP URL，使用 Bearer Token 进行统一鉴权。
Endpoint
POST https://api.muirouter.com/mcp
Header
Authorization: Bearer sk-gw-xxxxxxxx
3. 多 Server 聚合接入（Claude Code 示例）
在 ~/.claude/mcp.json 中将 MuiRouter 与本地文件系统等其他 MCP servers 共同配置，实现集中分发。
{
  "mcpServers": {
    "muirouter": {
      "url": "https://api.muirouter.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-gw-xxxxxxxx"
      }
    },
    "local-tools": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

重启 Claude Code 后输入 /mcp 即可查看所有已连接 server 聚合后的完整工具列表。

4. 在 Cursor / Claude Desktop / Cline 中接入
使用相同的 streamable-HTTP 端点与 Authorization 请求头完成配置。

Cursor：Settings → MCP → Add new server，选择 streamable-http 类型，将 URL 设为 https://api.muirouter.com/mcp，添加自定义请求头 Authorization: Bearer sk-gw-...。

Claude Desktop：编辑配置文件（macOS：~/Library/Application Support/Claude/claude_desktop_config.json），填入相同的 JSON 配置。

5. 内置账户与 AI 工具箱
内置六大核心工具，涵盖模型路由、余额查询、用量统计、图片生成与一键充值。
get_balance

查询当前 API Key 所属用户的钱包余额、累计充值和累计消费。

{ "name": "get_balance", "arguments": {} }
get_usage

分页查询当前用户的 API 用量，可按模型和时间范围筛选。

{ "name": "get_usage", "arguments": { "limit": 20, "model": "gpt-4o" } }
list_recharges

分页查询当前用户的充值记录。

{ "name": "list_recharges", "arguments": { "limit": 20 } }
list_models

列出 MuiRouter 当前支持的所有模型及其定价（input/output、markup_rate）。

{ "name": "list_models", "arguments": {} }
create_topup_session

创建 Stripe 充值会话，返回支付链接，AI 客户端可引导用户完成支付。

{ "name": "create_topup_session", "arguments": { "amount_cents": 1000, "currency": "usd" } }
image_generation

通过 MuiRouter 调用 OpenAI 兼容的图片生成接口（消耗钱包余额）。

{ "name": "image_generation", "arguments": { "model": "gpt-image-2", "prompt": "a cute cat" } }
6. 直接调用 JSON-RPC 与 curl 调试
无需客户端，也可以直接使用 curl 测试服务发现、工具列表与工具执行。
# Discover server capabilities (Modern 2026-07-28)
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"protocolVersion":"2026-07-28"}}}'

# List tools
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Call get_balance
curl -X POST https://api.muirouter.com/mcp \
  -H "Authorization: Bearer sk-gw-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":3,
    "method":"tools/call",
    "params": {"name":"get_balance","arguments":{}}
  }'
7. 安全须知与最佳实践

• API Key 等同于访问凭证——切勿在公开仓库或聊天记录中泄露，发现异常请立即在 Keys 页面吊销。

• 图片生成与创建充值会涉及资金变动，建议在 AI 客户端中为此类敏感工具开启交互确认。

• 严格进行 Origin 安全校验防范 DNS rebinding；并发与计费规则与 REST API 保持一致。

相关指南与对比

MCP 路由与网关什么是 MCP 服务器？MuiRouter vs OpenRouterAI API 路由按 token 计费