用途
CapMonster Cloud MCP Server 是一个基于 Model Context Protocol(MCP)的服务器,用于让 AI 智能体自行解决验证码。它作为 CapMonster Cloud 的官方 MCP 实现,提供 Python 包以及 TypeScript 移植版(位于 ts/ 目录),可与 Claude Desktop、Cursor 及其他 MCP 客户端配合使用。
主要能力
该服务器提供以下功能:
- 列出 CapMonster Cloud 支持的验证码类型。
- 向智能体提供 CapMonster 的实时文档。
- 创建求解任务,并针对 CapMonster Cloud REST API 轮询任务结果。
支持的验证码类型包括(以 get_supported_tasks 工具从实时 OpenAPI 规范返回的权威列表为准):
- reCAPTCHA(v2、v2 Enterprise、v3)
- Cloudflare Turnstile 和 Cloudflare Challenge(managed challenge / cf_clearance)
- FunCaptcha(Arkose)
- GeeTest(v3 和 v4)
- 企业级反机器人系统:AWS WAF、DataDome、Imperva、TSPD、Binance、Prosopo、Yidun、TenDI、Hunt、Altcha、Basilisk 等
- 图像转文本及复杂图像任务
注意:当前不支持 hCaptcha。
使用方式
该服务器仅负责求解环节,自身没有浏览器。需要搭配一个驱动浏览器的 MCP(例如 capmonster-mcp-patchright)来完成页面工作(导航、交互、读取实时 DOM/网络,并将求解后的令牌注入回页面)。完整的分步流程可参考 capmonster_agent/SKILL.md。
使用步骤:
- 获取 API Key。
- 将服务器添加到 MCP 客户端配置中。
- 要求智能体打开受验证码保护的页面并解决它。
运行要求:Python 3.11+ 和有效的 CapMonster API Key。可使用 uvx 运行(无需本地克隆)。如果偏好 TypeScript/Node,可查看 ts/README.md 中 npm 发布的移植版——工具相同,行为相同。
与 MCP 客户端(如 Claude Desktop)配合使用时,将配置添加到 MCP 客户端的配置文件中(例如 claude_desktop_config.json)。该服务器仅通过 stdio 运行,因此没有 HTTP 头来携带每请求密钥——CM_API_KEY 从环境变量读取一次,并在会话中的每次工具调用中共享。
建议搭配浏览器自动化 MCP 服务器(例如 capmonster-mcp-patchright),这样智能体既能查看页面,也能解决页面上的验证码——可参考 mcp.example.json 中同时配置两个服务器的示例。
可用 MCP 工具
连接后,LLM 可访问以下工具:
- get_supported_tasks:从实时 OpenAPI 规范列出 CapMonster 支持的验证码任务类型。
- get_task_parameters(task_type):获取某任务类型的必填/可选字段、变体说明及解决方案模式。
- get_docs(url, offset, limit, section):获取 CapMonster 文档页面(仅限 docs.capmonster.cloud / api.capmonster.cloud),支持章节跳转和分页。
- create_task(task):提交验证码任务并返回 taskId。
- get_task_result(task_id):轮询一次任务结果。
- get_task_result_wait(task_id, timeout_seconds, poll_interval_seconds):轮询任务直至完成(优于自行驱动轮询循环)。
- get_actual_user_agent():获取当前 Windows User-Agent,用于在浏览器和求解任务之间保持一致的指纹。
- get_balance():检查当前 CapMonster Cloud API 余额。
适用场景
适用于需要让 AI 智能体自动处理验证码的自动化流程,例如在受验证码保护的页面上进行测试、数据采集或自动化操作(需在拥有权限的网站上使用)。
限制
- 该服务器本身不含浏览器,必须搭配浏览器自动化 MCP 使用。
- 仅通过 stdio 运行,API Key 从环境变量读取一次并在会话中共享。
- 当前不支持 hCaptcha。
- 需要 Python 3.11+ 和有效的 CapMonster API Key。
- 仅应在拥有或获得自动化许可的网站上使用,并遵守相关网站的服务条款和适用法律。
官方文档
- CapMonster Cloud MCP 页面
- CapMonster Cloud 主文档
- Model Context Protocol (MCP) 文档