cloro

cloro MCP 服务

cloro MCP 服务的源代码，为任何支持 MCP 的 Agent 提供查询 ChatGPT、Perplexity、Gemini、Copilot、Grok、Google AI Mode、Google Search 和 Google News 的工具。向 Agent 提问 “检查 ChatGPT 是否推荐我们作为最佳 SERP API”，它就会调用 cloro API，并基于解析后的答案及其引用来源进行推理。

可托管运行于 mcp.cloro.dev，也可在本地通过 stdio 运行。

如何将 Agent 连接到 cloro MCP 服务？

在 Claude 中，你可以通过 OAuth 登录，无需密钥：

1. 前往 Customize → Connectors，然后选择 Add custom connector。
2. 输入 https://mcp.cloro.dev/mcp。在 Authentication 下，选择 Sign in when needed。
3. 让 Claude 使用 cloro 工具。登录 cloro，并选择用于支付调用费用的组织。

其他客户端使用来自控制面板的 cloro API 密钥。托管服务使用 Streamable HTTP。将密钥放在 URL 路径中，以便无法设置自定义标头的客户端使用：

{
  "mcpServers": {
    "cloro": {
      "type": "http",
      "url": "https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp"
    }
  }
}

如果你的客户端可以设置标头，请使用 https://mcp.cloro.dev/mcp，并设置 Authorization: Bearer YOUR_CLORO_API_KEY。在 Claude Code 中：

claude mcp add --transport http cloro https://mcp.cloro.dev/YOUR_CLORO_API_KEY/mcp

在 Cursor 中

此代码库也提供 Cursor 插件。可从 Cursor 插件市场安装，或让 Cursor 指向此代码库，Cursor 会提示你设置一个变量：

变量	值
CLORO_API_KEY	来自控制面板的密钥

Cursor 会在自身端存储密钥，并以 Authorization: Bearer 的形式发送，因此密钥不会出现在 URL 或代码库中。清单文件为 .cursor-plugin/plugin.json，服务定义文件为 mcp.json。

自行运行

npm install
npm run build
MCP_TRANSPORT=stdio CLORO_API_KEY=your_key node dist/index.js

MCP_TRANSPORT 可设为 http（默认值）或 stdio。在 stdio 模式下，客户端会启动进程，密钥来自 CLORO_API_KEY；在 http 模式下，密钥随请求传入，服务端不配置密钥。PORT 默认为 8095，CLORO_API_URL 默认为 https://api.cloro.dev。

除非设置 CLERK_ISSUER，否则 OAuth 默认关闭。托管服务将其设为 https://clerk.cloro.dev。api.cloro.dev 只接受来自该签发方的令牌，因此，将请求转发到该服务的可自托管服务端必须使用相同的值。MCP_PUBLIC_URL（默认值为 https://mcp.cloro.dev）用于设置受保护资源元数据中的资源 URL。

它提供哪些工具？

工具	端点
scrape_chatgpt	POST /v1/monitor/chatgpt
scrape_gemini	POST /v1/monitor/gemini
scrape_copilot	POST /v1/monitor/copilot
scrape_perplexity	POST /v1/monitor/perplexity
scrape_grok	POST /v1/monitor/grok
scrape_google_ai_mode	POST /v1/monitor/aimode
scrape_google	POST /v1/monitor/google
scrape_google_news	POST /v1/monitor/google/news
list_countries	GET /v1/countries
list_states	GET /v1/states

助手工具接受 prompt 和 country（ISO 3166-1 alpha-2），还可选接受 state，用于定位美国的州级区域。Google 工具接受 gl 来指定结果地理位置，并可选接受 hl 来指定界面语言；country 仍可作为 gl 的已弃用别名使用。scrape_google_ai_mode 使用 location 或 uule 定位国家/地区以下的区域，而不是使用 state。scrape_google 可以通过 query 和 gl 运行，也可以使用包含查询内容和分页信息的完整 google.com/search URL；它还接受 include.aioverview，用于获取 Google 的 AI Overview。每个工具都可选接受 include 对象，以返回较大的负载字段；若要获得最精简的响应，请不要设置该对象。

scrape_grok 已注册，但 Grok 已停止服务：未登录访客访问 grok.com 时会看到注册墙。cloro API 会以 400（MODEL_UNAVAILABLE）拒绝对此工具的调用，且这些调用不消耗额度。

工作原理

该服务不包含业务逻辑，也不保存任何密钥。每个请求都会将调用者自己的凭证（API 密钥或 OAuth 访问令牌）作为 Bearer 令牌转发给 api.cloro.dev，因此身份验证、额度计费、速率限制和并发控制都由 API 而非本服务执行。在 http 模式下，每个 POST 请求都会创建一个绑定到调用者凭证的新服务和传输，因此同一部署可供所有人使用，且无需保存会话状态。

initialize 和 tools/list 无需凭证即可响应，因此客户端可以在登录前列出工具。首次在未提供凭证时调用 tools/call，会返回 401，并附带指向 /.well-known/oauth-protected-resource/mcp 的 WWW-Authenticate 标头。OAuth 客户端从该地址读取授权服务器信息并执行授权流程。服务会根据颁发者的公开 JWKS 验证令牌签名（代码位于 src/oauth-tokens/），因此无需 Clerk 密钥。

工具输入架构与 API 用于验证的 zod 架构相同，这些架构从 cloro 后端复制到 src/schemas/ 中。由于该软件包未发布，因此采用复制而非导入的方式。如果两者出现不一致，请以API 参考为准。

常见问题

我需要自行托管吗？

不需要。mcp.cloro.dev 已托管，也是大多数人应该选择的方式。此代码库的作用是让你查看实际运行的内容，并在你的配置需要时自行托管。

会消耗额度吗？

抓取工具会调用计费端点，所以会消耗额度，费率与 API 相同。list_countries 和 list_states 读取固定的参考列表，不收费。请参阅定价。

为什么 API 密钥在 URL 中？

因为有几个 MCP 客户端无法设置自定义标头。如果你的客户端支持，请改用 Authorization 标头形式，并避免将密钥放在路径中。如果你的客户端支持 OAuth，请使用 OAuth，这样就无需密钥。URL 路径只接受 API 密钥，不接受 OAuth 令牌。

请求超时时间是多少？

320 秒。同步抓取在服务器端最长可能需要五分钟，因此为客户端预留了充足的时间。对于长时间运行的批处理，请使用异步任务 API，而不是 MCP。

了解更多

• 集成指南： cloro.dev/docs/integrations/mcp
• API 参考： cloro.dev/docs

许可证

MIT。请参阅 LICENSE。