Ergora Specialists

Ergora 专家 MCP

为 Claude Desktop、Claude Code、Cursor 和任何 MCP 客户端提供 17 个行业领域知识专家（销售、营销、付费广告、内容、电商、创业、商业战略、社区、创作者、设计与 UX、开发、财务、人力资源、领导力、法律、本地营销、公关），以工具的形式提供。

每个工具都会从精选的知识库中返回经过总结且附有引用来源的见解，知识库涵盖知名从业者、畅销书以及学术和监管来源。免费版：匿名用户每天可查询 5 次，提供电子邮件地址后每天可查询 30 次。

Ergora 将这 17 位专家全部作为完整的 AI 专家 Agent 运行，可无限使用：https://ergora.app

安装：远程服务（无需下载）

服务 URL：https://ergora-specialists-gateway.contact-c9e.workers.dev/mcp（MCP Streamable HTTP，无需身份验证）

Claude Code

claude mcp add --transport http ergora-specialists https://ergora-specialists-gateway.contact-c9e.workers.dev/mcp --header "X-Ergora-Email: [email protected]"

Claude Desktop / claude.ai：打开设置，选择连接器，点击 添加自定义连接器，然后粘贴服务 URL。无需登录；Claude 询问时，提供你的电子邮件地址，即可解锁每天 30 次查询（它会通过工具的 email 参数传递该地址）。

Cursor：.cursor/mcp.json：

{
  "mcpServers": {
    "ergora-specialists": {
      "url": "https://ergora-specialists-gateway.contact-c9e.workers.dev/mcp",
      "headers": { "X-Ergora-Email": "[email protected]" }
    }
  }
}

任何其他 MCP 客户端：使用 Streamable HTTP 传输协议连接到该 URL。服务是无状态的（仅支持 POST，返回 JSON 响应）。可选的 X-Ergora-Email 标头用于识别你的身份，以享受每天 30 次的免费额度。

安装：本地 stdio 服务（npm）

软件包：ergora-specialists-mcp（Node 18+）。

Claude Code

claude mcp add ergora-specialists -e [email protected] -- npx -y ergora-specialists-mcp

Claude Desktop / Cursor：claude_desktop_config.json / .cursor/mcp.json：

{
  "mcpServers": {
    "ergora-specialists": {
      "command": "npx",
      "args": ["-y", "ergora-specialists-mcp"],
      "env": { "ERGORA_EMAIL": "[email protected]" }
    }
  }
}

也可以从源代码安装：git clone https://github.com/ergoracloud/ergora-specialists && cd ergora-specialists/mcp && npm install，然后将 command 指向 node /absolute/path/to/mcp/index.js。

工具

• ergora_sales、ergora_marketing、ergora_ads、ergora_content、ergora_ecommerce、ergora_entrepreneurship、ergora_business_strategy、ergora_community、ergora_creator、ergora_design、ergora_developer、ergora_finance、ergora_hr、ergora_leadership、ergora_legal、ergora_local、ergora_pr：每位专家各对应一个工具。输入：{ query, top_k?, email?, subscribe? }。
• ergora_ask：跨领域查询（可选指定 vertical）。
• ergora_list_specialists：查看可用专家。

免费版

你的电子邮件地址就是访问密钥：每天可查询 30 次。通过 X-Ergora-Email 标头（远程服务）、ERGORA_EMAIL（本地）或工具的 email 参数提供。未提供电子邮件地址时，每个 IP 地址每天最多可查询 5 次。合理使用限制：每个网络每分钟约 30 次请求；超过该限制的突发请求会收到 429。MCP 批次最多包含 5 条消息。

为确保免费版公平使用，同一个邮箱只计为一个（不区分大小写，忽略 +tags 和 Gmail 地址中的点号）；每个网络每天最多可使用 3 个不同的未确认邮箱，且同一网络的未确认流量共享每日上限。已确认的邮箱不受这些网络上限影响。在共享出口地址的托管客户端（例如 Claude）中，匿名用户可用的额度较少，未确认邮箱每天可查询 10 次。

整个服务还设有共享的每日限额（每天 2,500 次查询），其中一部分预留给已确认的邮箱和托管客户端。达到限额后，所有调用者都会收到明确提示：“请明天（00:00 UTC）重试或使用 Ergora”，该提示会持续到下一个 UTC 日期开始。

确认电子邮件地址是可选的。你使用某个电子邮件地址进行几次查询且跨越不止一天后（或者直接传入 subscribe: true），我们可能会发送一封邮件，请你确认该地址。只有已确认的地址才会加入 Ergora 的邮件列表（我们会偶尔发送更新，你可以随时退订）。未确认的电子邮件地址仅用于计算你的配额，并会在 60 天后删除。不会与第三方共享。

网关不会发送 CORS 标头：请从服务端、MCP 客户端或 stdio 软件包调用，不要从浏览器 JavaScript 调用。

工作原理

查询会发送到 Cloudflare Worker 网关。网关使用 Workers AI（bge-small-en-v1.5）将问题转换为嵌入向量，并在 Ergora 知识库的隔离向量存储中进行搜索（绝不会访问 Ergora 的生产客户数据库）。仅返回来源位于已审核许可名单中的获批条目。结果为摘要，并附有原始来源链接，不会逐字复现内容。如果向量搜索不可用或超出预算，网关会改用同一批条目的关键词索引作答，并说明这一点。

架构（此仓库）

• worker/：Cloudflare Worker（TypeScript），构建为可在 Workers Free 套餐上运行。
  • /mcp 远程 MCP 端点、POST /query JSON API、/health 和 /health/deep、/confirm 邮件确认。
  • Vectorize ergora-kb-v2（384d）用于语义搜索，D1 ergora-kb-fts（FTS5）用于关键词回退，Workers AI 用于查询嵌入。
  • SQLite Durable Object（Gate）存储配额、24 小时响应缓存、告警标记和待处理的邮件确认。
  • PUBLIC_BASE_URL 设置确认链接所用的公开源站（留空表示使用请求源站），因此自定义域名只需更改一个变量。
  • npm run check 会运行类型检查、lint、测试和试运行打包。先执行预检，再按照 docs/RUNBOOK_v2.md 使用 npm run deploy 部署。
• sync/：每周知识库同步（kb_v2_sync.py，在 Ergora 的后台服务器上运行）：读取获批行，应用共享的来源策略，使用与 Worker 相同的模型生成嵌入，并移除不再符合条件的条目。eval_models.py 用于比较不同嵌入模型在实际知识库上的表现。
• shared/source_policy.json：Worker 和同步任务共用的来源许可名单。
• mcp/：本地 stdio MCP 服务（/query 的轻量客户端）。node e2e-test.mjs（stdio）和 node e2e-remote-test.mjs（远程）用于对线上网关进行端到端检查。
• docs/COSTS.md：免费套餐的限额计算，以及 Free 与 Paid 套餐的对比。

MIT，详见 LICENSE。