SuperAPI AI 工具集

capmonster-mcp-captcha-solver

CapMonster Cloud 官方 MCP 服务器,让 AI 智能体(如 Claude、Cursor 等)通过 Model Context Protocol 直接识别并解决验证码。支持 reCAPTCHA v2/v3、Cloudflare Turnstile、DataDome 等多种类型,提供列出支持任务、查询任务参数、获取文档、创建任务、轮询结果、查询余额等工具。该服务器仅负责求解环节,本身不含浏览器,需搭配浏览器自动化 MCP 使用。需要 Python 3.11+ 和有效的 CapMonster API Key。

访问官网

工具介绍

用途

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。

使用步骤:

  1. 获取 API Key。
  2. 将服务器添加到 MCP 客户端配置中。
  3. 要求智能体打开受验证码保护的页面并解决它。

运行要求: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) 文档