2Captcha MCP — MCP-сервер для Claude Code: 43 инструмента капчи
Отдаёт агенту весь API 2Captcha: 31 тип капчи, баланс, отчёты и pingback. Пригодится, когда нужно решать капчу прямо из кода.
Открыть на GitHubЧто делает 2Captcha MCP
Сервер поднимается по stdio и работает поверх официального SDK 2captcha-python (AsyncTwoCaptcha). Повторы, опрос результата и разбор ответов SDK берёт на себя, поэтому новый тип капчи появляется здесь сразу, как только его добавят в SDK. Всего 43 инструмента: 31 решатель, 5 инструментов управления, 3 для pingback и 3 для событий вебхука, плюс составной инструмент «решить и дождаться».
Управление закрывает базовые вещи: twocaptcha_balance показывает баланс в долларах, twocaptcha_report_good и twocaptcha_report_bad отправляют отчёт по id капчи, а twocaptcha_send_raw служит лазейкой для методов, которых в сервере ещё нет. Настройки берутся из переменных окружения: ключ API обязателен, сервер по умолчанию 2captcha.com (можно переключить на rucaptcha.com), таймаут 120 секунд, для reCAPTCHA — 600, интервал опроса 10 секунд.
Без ключа API сервер не заработает: его нужно положить в .env как 2Captcha_API_KEY или передать при регистрации. Три решателя — datadome, captchafox и vkcaptcha — требуют proxy и user_agent прямо в вызове, без них SDK не примет запрос. Отчёт по капче принимается только в течение 15 минут после решения.
Какие задачи решает
- решить reCAPTCHA или Turnstile по sitekey и URL страницы
- распознать текст с картинки и отдать результат агенту
- проверить баланс аккаунта 2Captcha перед запуском парсера
- отправить отчёт по капче, если ответ оказался неверным
- завести и удалить pingback-адреса для автоматического получения результата
Примеры запросов агенту
- Проверь баланс через
twocaptcha_balance. - Реши reCAPTCHA на этой странице: sitekey и url я дам.
- Зарегистрируй pingback на наш колбэк-адрес.
Как установить 2Captcha MCP
1Команда из источника
Команду источника здесь не показываем: в ней служебные символы оболочки. Возьмите её из README репозитория и сначала прочитайте
2Командой платформы
claude mcp add 2captcha-mcp -- uvx twocaptcha-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from twocaptcha-mcp <команда>
Командой платформы
codex mcp add 2captcha-mcp -- uvx twocaptcha-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from twocaptcha-mcp <команда>
Файл настроек
{
"mcpServers": {
"2captcha-mcp": {
"command": "uvx",
"args": [
"twocaptcha-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from twocaptcha-mcp <команда>
Файл настроек
{
"servers": {
"2captcha-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"twocaptcha-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from twocaptcha-mcp <команда>
Командой платформы
gemini mcp add 2captcha-mcp uvx twocaptcha-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from twocaptcha-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о 2Captcha MCP
Как установить 2Captcha MCP в Claude Code?
Одной командой: claude mcp add 2captcha-mcp -- uvx twocaptcha-mcp. После перезапуска claude сервер подхватится.
Что делает 2Captcha MCP?
Даёт агенту доступ к API 2Captcha: 31 решатель капчи, управление балансом и отчётами, работа с pingback и вебхуками. Всего 43 инструмента.
Что нужно для работы сервера?
Ключ 2Captcha в переменной 2Captcha_API_KEY и Python 3.11+. Для datadome, captchafox и vkcaptcha в вызове обязательны proxy и user_agent.
