CapMonster Cloud MCP Captcha Solver

Servidor MCP CapMonster Cloud (Model Context Protocol)

Um servidor Model Context Protocol (MCP) para CapMonster Cloud, disponível como pacote Python e como porta TypeScript (ts/).

Este servidor é o cérebro de resolução: ele lista os tipos de captcha suportados, serve a documentação ao vivo da CapMonster e cria/consulta tarefas de resolução contra a API REST da CapMonster Cloud. Ele não possui navegador próprio — combine-o com um MCP de automação de navegador (ex.: capmonster-mcp-patchright) que faz o trabalho de página (navegação, interação, leitura do DOM/rede ao vivo e injeção do token resolvido de volta na página). Veja capmonster_agent/SKILL.md para o procedimento completo passo a passo para analisar uma página protegida por captcha e resolvê-la dessa forma.

👉 Obtenha sua Chave de API Gratuita e Comece a Contornar CAPTCHAs

---

⚡ CAPTCHAs Suportados

Seu Agente de IA será capaz de contornar automaticamente, entre outros:

• reCAPTCHA (v2, v2 Enterprise, v3)
• Cloudflare Turnstile e Cloudflare Challenge (desafio gerenciado / cf_clearance)
• FunCaptcha (Arkose)
• GeeTest (v3 e v4)
• Sistemas Anti-Bot Empresariais: AWS WAF, DataDome, Imperva, TSPD, Binance, Prosopo, Yidun, TenDI, Hunt, Altcha, Basilisk e outros
• Tarefas de Imagem para Texto e Imagens Complexas

A lista atual e autoritativa é servida ao vivo a partir da especificação OpenAPI da CapMonster através da ferramenta get_supported_tasks — hCaptcha não é suportado atualmente, apesar de aparecer em alguns materiais de marketing da própria CapMonster.

📦 Instalação

Requer Python 3.11+ e uma Chave de API CapMonster válida. Execute com uvx (sem necessidade de clonar localmente):

uvx capmonster-mcp

Prefere TypeScript/Node? Veja ts/README.md para a porta publicada no npm — mesmas ferramentas, mesmo comportamento.

🔌 Usando com um cliente MCP (ex.: Claude Desktop)

Adicione o seguinte à configuração do seu cliente MCP (ex.: claude_desktop_config.json):

{
  "mcpServers": {
    "capmonster": {
      "command": "uvx",
      "args": ["capmonster-mcp"],
      "env": {
        "CM_API_KEY": "your_api_key_here"
      }
    }
  }
}

O servidor só roda via stdio, então não há cabeçalhos HTTP para transportar uma chave por requisição — CM_API_KEY é lido uma vez do ambiente e compartilhado por todas as chamadas de ferramenta na sessão.

Combine-o com um servidor MCP de automação de navegador (ex.: capmonster-mcp-patchright) para que seu agente possa tanto ver a página quanto resolver o que está nela — veja mcp.example.json para uma configuração com ambos os servidores conectados juntos.

🛠 Ferramentas MCP Disponíveis

Uma vez conectado, seu LLM terá acesso às seguintes ferramentas:

• get_supported_tasks: Lista os tipos de tarefa de captcha que a CapMonster suporta, a partir da especificação OpenAPI ao vivo.
• get_task_parameters(task_type): Campos obrigatórios/opcionais, notas de variantes e o esquema de solução para um tipo de tarefa.
• get_docs(url, offset, limit, section): Busca uma página de documentação da CapMonster (apenas docs.capmonster.cloud / api.capmonster.cloud), com salto de seção e paginação.
• create_task(task): Envia uma tarefa de captcha e retorna um taskId.
• get_task_result(task_id): Consulta uma tarefa uma vez.
• get_task_result_wait(task_id, timeout_seconds, poll_interval_seconds): Consulta uma tarefa até a conclusão (preferível a conduzir o loop de consulta você mesmo).
• get_actual_user_agent(): Busca um User-Agent atual do Windows para usar como uma impressão digital consistente entre o navegador e a tarefa de resolução.
• get_balance(): Verifica o saldo atual da sua API CapMonster Cloud.

📚 Documentação Oficial

• Documentação Principal da CapMonster Cloud
• Documentação do Model Context Protocol (MCP)

📄 Licença

MIT