
2Captcha MCP
io.github.aruxojuyu665由 GitHub 账号 aruxojuyu665 发布v0.6.1更新于 Oct 27, 2026
Full 2Captcha API (43 tools) for Claude Code: 31 captcha solvers + management + webhook.
发布方自己的服务:captcha.cc Human Verification
概览
把完整的 2Captcha API 封装为 43 个工具,让助手提交验证码求解、查询余额并管理回调地址。
- 可以做什么
- 提交 31 种验证码求解,涵盖图片、文字、音频、宫格、reCAPTCHA、hCaptcha、Turnstile、GeeTest 等类型
- 一次调用提交验证码并等待结果,或按验证码 ID 手动轮询
- 查询账户余额,并对求解结果标记正确或错误
- 注册、列出和删除 pingback 回调地址
- 可选运行本地 webhook 接收器,把回调结果存入 SQLite,并提供列出、读取和清空这些记录的工具
- 通过原始请求工具调用尚未封装的接口
- 适用场景
- 适用于助手需要在用户获授权的网站上处理验证码挑战,或需要脚本化 2Captcha 账户操作(如查余额、管理回调)的场景。普通浏览或不涉及验证码的抓取无需安装。
- 运行要求
- 以本地 Python stdio 进程运行,从 PyPI 安装后用 uvx 或 python -m 启动。需要 2Captcha API 密钥,通过 2Captcha_API_KEY 等环境变量提供,并需要访问 2Captcha 服务的网络连接。可选设置包括服务器地址、超时、轮询间隔和默认回调地址。
安装
在 SourceWeft 中
- 打开 控制台中的 2Captcha MCP,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
2Captcha MCP
[PyPI version] [Python 3.11+] [CI] [codecov] [mypy: strict] [License: MIT]
MCP server exposing the full 2Captcha API surface — 31 captcha types, 5 management tools, 3 pingback CRUD tools, 3 webhook event-store tools, and 1 composite solve-and-wait tool (43 tools total) — to Claude Code via stdio.
Built on the official 2captcha-python SDK (AsyncTwoCaptcha), so retry/polling/parsing are handled upstream and every captcha type the SDK supports is available the moment the SDK adds it.
Quick start
Create a .env next to the project root:
Verify it works:
Register the server with Claude Code:
After a claude restart, prompt the model with:
"Use twocaptcha_balance to check my account."
Configuration
All settings are environment-driven. Aliases in priority order:
Tools
Captcha solvers (31)
⚑ — proxy and user_agent are required by the SDK signature.
All solver tools accept the same set of optional kwargs (mixin SolverKwargs):
proxy: {type, uri}(HTTP/HTTPS/SOCKS4/SOCKS5)pingback: HttpUrl— per-call pingback URL (must be pre-registered)soft_id: intcookies: struser_agent: strlang: strheader_acao: 0|1
Management (5)
twocaptcha_balance— current balance in USDtwocaptcha_report_good/twocaptcha_report_bad— report a captcha id within 15 minutestwocaptcha_get_result— poll a captcha id manually (paired withsend_raw)twocaptcha_send_raw— escape hatch for SDK methods this server does not yet expose
Pingback CRUD (3)
twocaptcha_register_pingback— whitelist a callback URLtwocaptcha_list_pingbacks— list whitelisted addressestwocaptcha_delete_pingback— delete one oraddr="all"
Development
Run live tests against the real 2Captcha API (consumes credits):
Architecture
Tool handlers depend only on the SolverClient / PingbackClient abstractions — the SDK is never imported from a handler. Adding a new captcha type is a 3-step process: schema → tool handler → snapshot test count bump.
Webhook receiver (optional, since 0.3.0)
For long-running solves (recaptcha v3 up to 600 s), the polling-mode SDK call
holds the MCP request slot for the entire duration. Run the optional
twocaptcha-mcp-webhook server to flip into pingback mode — 2Captcha POSTs the
result to your URL, the receiver writes it to SQLite, and the MCP tools read
asynchronously without blocking.
- Composite tool:
twocaptcha_solve_and_wait_pingbacksends the captcha and waits on the local store - Read tools:
twocaptcha_pingback_events_list/get/clear - Deployment: docs/DEPLOY-WEBHOOK.md
- Troubleshooting: TROUBLESHOOTING.md
Contributing
See CONTRIBUTING.md for the dev loop, code conventions, and the SemVer policy for the MCP tool surface.
Security
See SECURITY.md. Vulnerabilities are reported privately via GitHub Security Advisory.
License
MIT — see LICENSE.
Registry verification — mcp-name: io.github.aruxojuyu665/twocaptcha-mcp
来源:README.md,提交 8d0b639
工具
0版本历史
1- v0.6.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Captcha 集成

captcha.cc Human Verification
cc.captcha官方发布者
面向 captcha.cc 的远程 MCP 服务器,帮助助手生成 CAPTCHA 集成代码片段,并创建实时挑战用于测试。

CaptchaNo
由 GitHub 账号 DishantSinghDev2 发布
CaptchaNo MCP 服务器让 AI 助手通过付费打码服务解决 reCAPTCHA v2/v3/Enterprise、Turnstile、DataDome 和图片验证码。

rea-captcha
由 GitHub 账号 masakaai 发布
一个本地 stdio MCP 服务器,在代理已有的浏览器会话中检测 CAPTCHA 验证挑战,并协调授权完成或人工接管,然后恢复原任务。

Capmonster Mcp Patchright Captcha Solver
由 GitHub 账号 CapMonsterCloud 发布
基于 Patchright 的隐蔽浏览器自动化 MCP 服务器,为助手提供 66 个工具,用于在反爬网站上驱动 Chrome。

Capmonster Mcp Captcha Solver
由 GitHub 账号 CapMonsterCloud 发布
CapMonster Cloud 官方 MCP 服务器,让 AI 代理提交验证码任务(reCAPTCHA、Turnstile、DataDome 等)并取回解题令牌。