CapMonster Cloud MCP Captcha Solver

Servidor MCP de CapMonster Cloud (Protocolo de Contexto de Modelo)

Un servidor de Protocolo de Contexto de Modelo (MCP) para CapMonster Cloud, disponible como paquete de Python y como puerto de TypeScript (ts/).

Este servidor es el cerebro de resolución: lista los tipos de captcha compatibles, sirve la documentación en vivo de CapMonster y crea/consulta tareas de resolución contra la API REST de CapMonster Cloud. No tiene navegador propio — combínalo con un MCP que controle el navegador (p. ej. capmonster-mcp-patchright) que haga el trabajo de la página (navegación, interacción, lectura del DOM/red en vivo e inyección del token resuelto de vuelta en la página). Consulta capmonster_agent/SKILL.md para el procedimiento completo paso a paso para analizar una página protegida por captcha y resolverla de esta manera.

👉 Obtén tu Clave de API Gratuita y Comienza a Evadir CAPTCHAs

---

⚡ CAPTCHAs Compatibles

Tu Agente de IA podrá evadir automáticamente, entre otros:

• reCAPTCHA (v2, v2 Enterprise, v3)
• Cloudflare Turnstile y Cloudflare Challenge (desafío gestionado / cf_clearance)
• FunCaptcha (Arkose)
• GeeTest (v3 y v4)
• Sistemas Anti-Bot Empresariales: AWS WAF, DataDome, Imperva, TSPD, Binance, Prosopo, Yidun, TenDI, Hunt, Altcha, Basilisk y más
• Tareas de Imagen a Texto e Imágenes Complejas

La lista autoritativa y actual se sirve en vivo desde la especificación OpenAPI de CapMonster a través de la herramienta get_supported_tasks — hCaptcha no es compatible actualmente, a pesar de aparecer en algunos textos de marketing de CapMonster.

📦 Instalación

Requiere Python 3.11+ y una Clave de API de CapMonster válida. Ejecútalo con uvx (sin necesidad de clonar localmente):

uvx capmonster-mcp

¿Prefieres TypeScript/Node? Consulta ts/README.md para el puerto publicado en npm — mismas herramientas, mismo comportamiento.

🔌 Uso con un cliente MCP (p. ej. Claude Desktop)

Añade lo siguiente a la configuración de tu cliente MCP (p. ej. claude_desktop_config.json):

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

El servidor solo se ejecuta a través de stdio, por lo que no hay cabeceras HTTP para transportar una clave por solicitud — CM_API_KEY se lee una vez desde el entorno y se comparte en cada llamada de herramienta de la sesión.

Combínalo con un servidor MCP de automatización de navegador (p. ej. capmonster-mcp-patchright) para que tu agente pueda tanto ver la página como resolver lo que hay en ella — consulta mcp.example.json para una configuración con ambos servidores conectados juntos.

🛠 Herramientas MCP Disponibles

Una vez conectado, tu LLM tendrá acceso a las siguientes herramientas:

• get_supported_tasks: Lista los tipos de tareas de captcha que CapMonster soporta, desde la especificación OpenAPI en vivo.
• get_task_parameters(task_type): Campos obligatorios/opcionales, notas de variantes y el esquema de la solución para un tipo de tarea.
• get_docs(url, offset, limit, section): Obtiene una página de documentación de CapMonster (solo docs.capmonster.cloud / api.capmonster.cloud), con salto de sección y paginación.
• create_task(task): Envía una tarea de captcha y devuelve un taskId.
• get_task_result(task_id): Consulta una tarea una vez.
• get_task_result_wait(task_id, timeout_seconds, poll_interval_seconds): Consulta una tarea hasta su finalización (preferible a manejar el bucle de consulta tú mismo).
• get_actual_user_agent(): Obtiene un User-Agent de Windows actual para usarlo como una huella consistente entre el navegador y la tarea de resolución.
• get_balance(): Verifica tu saldo actual de la API de CapMonster Cloud.

📚 Documentación Oficial

• Documentación Principal de CapMonster Cloud
• Documentación del Protocolo de Contexto de Modelo (MCP)

📄 Licencia

MIT