
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 等)並取回解題權杖。