2Captcha MCP

Name: 2Captcha MCP
Author: aruxojuyu665

โดย aruxojuyu665รุ่น 0.6.1i★ –iรันบนเครื่อง

ชื่อใน registryio.github.aruxojuyu665/twocaptcha-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Full 2Captcha API (43 tools) for Claude Code: 31 captcha solvers + management + webhook.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังใหม่มาก↓ 20/สัปดาห์ · ★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: เครื่องมือนักพัฒนา
ต้องใส่ค่าเหล่านี้: 2Captcha_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: 2Captcha_API_KEY

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "twocaptcha": {
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add twocaptcha --env 2Captcha_API_KEY='ใส่ค่าของคุณ' -- uvx twocaptcha-mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "twocaptcha": {
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "twocaptcha": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

2Captcha_API_KEY ความลับ จำเป็น env
2Captcha account API key (https://2captcha.com/setting)

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 9 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub aruxojuyu665 ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi

ดาวมากกว่า 0% ของอีก 5564 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 11% ของอีก 5564 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 5564 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

2Captcha MCP ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: 2Captcha_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.6.1) เข้า registry 6 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี GitHub, Desktop Commander, Cloudflare MCP

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

GitHub

server ทางการของ GitHub ให้ AI อ่านและจัดการโค้ด issue และ pull request ในบัญชีของคุณได้ ใช้ผ่านคลาวด์ของ GitHub หรือรันในเครื่องด้วย Docker ก็ได้

โดย githubใช้กันมาก★ 34.2Kอัปเดต 5 วันที่ผ่านมา

บนเครื่องหรือคลาวด์

ติดตั้ง

Desktop Commander

MCP server for terminal commands, file operations, and process management

โดย wonderwhy-erใช้กันมาก↓ 709.6K/สัปดาห์★ 10.2Kอัปเดต 17 วันที่ผ่านมา

รันบนเครื่อง

ติดตั้ง

Cloudflare MCP

Cloudflare MCP servers

โดย cloudflareใช้กันมาก★ 4.4Kอัปเดต 14 เดือนที่ผ่านมา

รันบนคลาวด์✓ mcp.cloudflare.com

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

2Captcha MCP

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

pip install twocaptcha-mcp

or for development:

pip install -e ".[dev]"

Create a .env next to the project root:

2Captcha_API_KEY=your_2captcha_key_here

Verify it works:

python -m twocaptcha_mcp           # starts the stdio server (Ctrl+C to stop)

claude mcp add 2captcha -e 2Captcha_API_KEY=your_2captcha_key_here -- python -m twocaptcha_mcp

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:

Setting	Aliases	Default	Range
API key (required)	`2Captcha_API_KEY`, `TWOCAPTCHA_API_KEY`, `2CAPTCHA_API_KEY`, `API_KEY_2CAPTCHA`	—	—
Server	`TWOCAPTCHA_SERVER`	`2captcha.com`	`2captcha.com`, `rucaptcha.com`
Default timeout	`TWOCAPTCHA_DEFAULT_TIMEOUT`	`120` s	1..600
reCAPTCHA timeout	`TWOCAPTCHA_RECAPTCHA_TIMEOUT`	`600` s	1..1200
Polling interval	`TWOCAPTCHA_POLLING_INTERVAL`	`10` s	1..120
Soft id	`TWOCAPTCHA_SOFT_ID`	`4580`	—
Log level	`TWOCAPTCHA_LOG_LEVEL`	`INFO`	DEBUG/INFO/WARNING/ERROR/CRITICAL
Default pingback URL	`TWOCAPTCHA_DEFAULT_CALLBACK`	_unset_	https URL

Tools

Captcha solvers (31)

Tool	SDK method	Required arguments
`twocaptcha_solve_normal`	`normal`	`file_path` xor `file_base64`
`twocaptcha_solve_text`	`text`	`text`
`twocaptcha_solve_audio`	`audio`	file (xor), `audio_lang`
`twocaptcha_solve_grid`	`grid`	file (xor)
`twocaptcha_solve_canvas`	`canvas`	file (xor)
`twocaptcha_solve_coordinates`	`coordinates`	file (xor)
`twocaptcha_solve_rotate`	`rotate`	`files: list`
`twocaptcha_solve_vkimage`	`vkimage`	`files`, `steps`
`twocaptcha_solve_recaptcha`	`recaptcha`	`sitekey`, `url`, `version`, `enterprise`
`twocaptcha_solve_hcaptcha`	`hcaptcha`	`sitekey`, `url`
`twocaptcha_solve_turnstile`	`turnstile`	`sitekey`, `url` (+ `data`/`pagedata` for CF Challenge)
`twocaptcha_solve_funcaptcha`	`funcaptcha`	`sitekey`, `url`
`twocaptcha_solve_geetest`	`geetest`	`gt`, `challenge`, `url`
`twocaptcha_solve_geetest_v4`	`geetest_v4`	`captcha_id`, `url`
`twocaptcha_solve_capy`	`capy`	`sitekey`, `url`
`twocaptcha_solve_keycaptcha`	`keycaptcha`	`s_s_c_user_id`, `s_s_c_session_id`, two signs, `url`
`twocaptcha_solve_lemin`	`lemin`	`captcha_id`, `div_id`, `url`
`twocaptcha_solve_mtcaptcha`	`mtcaptcha`	`sitekey`, `url`
`twocaptcha_solve_friendly_captcha`	`friendly_captcha`	`sitekey`, `url`
`twocaptcha_solve_cutcaptcha`	`cutcaptcha`	`misery_key`, `apikey`, `url`
`twocaptcha_solve_amazon_waf`	`amazon_waf`	`sitekey`, `iv`, `context`, `url`
`twocaptcha_solve_tencent`	`tencent`	`app_id`, `url`
`twocaptcha_solve_atb_captcha`	`atb_captcha`	`app_id`, `api_server`, `url`
`twocaptcha_solve_datadome` ⚑	`datadome`	`proxy`, `user_agent`, `captcha_url`, `pageurl`
`twocaptcha_solve_captchafox` ⚑	`captchafox`	`proxy`, `user_agent`, `sitekey`, `pageurl`
`twocaptcha_solve_vkcaptcha` ⚑	`vkcaptcha`	`proxy`, `user_agent`, `redirect_uri`
`twocaptcha_solve_prosopo`	`prosopo`	`sitekey`, `pageurl`
`twocaptcha_solve_temu`	`temu`	`body`, `part1..3`
`twocaptcha_solve_altcha`	`altcha`	`pageurl`
`twocaptcha_solve_cybersiara`	`cybersiara`	`master_url_id`, `pageurl`, `cyber_user_agent`
`twocaptcha_solve_yandex_smart`	`yandex_smart`	`sitekey`, `url`

⚑ — 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: int
cookies: str
user_agent: str
lang: str
header_acao: 0|1

Management (5)

twocaptcha_balance — current balance in USD
twocaptcha_report_good / twocaptcha_report_bad — report a captcha id within 15 minutes
twocaptcha_get_result — poll a captcha id manually (paired with send_raw)
twocaptcha_send_raw — escape hatch for SDK methods this server does not yet expose

Pingback CRUD (3)

twocaptcha_register_pingback — whitelist a callback URL
twocaptcha_list_pingbacks — list whitelisted addresses
twocaptcha_delete_pingback — delete one or addr="all"

Development

pytest --cov=twocaptcha_mcp --cov-branch --cov-fail-under=92 -v

ruff check . && ruff format --check . mypy --strict twocaptcha_mcp

Run live tests against the real 2Captcha API (consumes credits):

pytest -m live --run-live          # balance + solve_normal + concurrent_balance

pytest -m e2e --run-e2e # full MCP protocol roundtrip via mcp.client.session

Architecture

twocaptcha_mcp/

├── main.py # stdio entrypoint ├── server.py # build_server + dispatch_tool_call ├── config.py # pydantic-settings (.env) ├── logger.py # stderr-only logger (stdout is reserved for stdio MCP) ├── client/ │ ├── solver.py # SolverClient — async wrapper over AsyncTwoCaptcha │ ├── pingback.py # httpx wrapper for legacy res.php │ ├── rate_limiter.py # async sliding-window per-method rate limiter │ └── errors.py # internal CaptchaError hierarchy ├── schemas/ # Pydantic request/response models per captcha family ├── tools/ # @captcha_tool handlers per captcha family + composite └── webhook_receiver/ # Starlette app + SQLite store (twocaptcha-mcp-webhook)

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_pingback sends 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

2Captcha MCP

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

GitHub

Desktop Commander

Cloudflare MCP

README จากผู้ทำ

2Captcha MCP

Quick start

or for development:

Configuration

Tools

Captcha solvers (31)

Management (5)

Pingback CRUD (3)

Development

Architecture

Webhook receiver (optional, since 0.3.0)

Contributing

Security

License