comet-mcp

comet-mcp

Dale a Claude Code un navegador que piensa.

Un servidor MCP que conecta Claude Code con Perplexity Comet - permitiendo navegación web agéntica, investigación profunda y monitoreo de tareas en tiempo real.

¿Por qué?

Las herramientas web existentes para Claude Code se dividen en dos categorías, ambas con limitaciones:

1. APIs de búsqueda (Tavily, Perplexity API, WebFetch)

Devuelven texto estático. Sin interacción, sin inicio de sesión, sin contenido dinámico. Ideales para consultas rápidas, pero no pueden navegar por sitios complejos ni rellenar formularios.

2. Automatización de navegador (browser-use, Puppeteer MCP, Playwright MCP)

Pueden interactuar con páginas, pero usan un enfoque un-agente-hace-todo: el mismo modelo de razonamiento que escribe tu código también decide dónde hacer clic, qué escribir y cómo navegar. Esto satura la ventana de contexto y fragmenta la atención.

3. Comet MCP: Delegación multi-agente

Comet MCP adopta un enfoque diferente. En lugar de que Claude controle un navegador directamente, delega en Perplexity Comet - una IA diseñada específicamente para investigación y navegación web.

• Claude se mantiene enfocado en tu tarea de codificación
• Comet maneja la navegación: navegación, muros de inicio de sesión, contenido dinámico, investigación profunda
• Resultado: la inteligencia de codificación de Claude + la inteligencia web de Perplexity, trabajando juntas

Inicio rápido

1. Configura Claude Code

Añade a ~/.claude.json o .mcp.json:

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"]
    }
  }
}

2. Instala Comet Browser

Descarga e instala Perplexity Comet.

¡Eso es todo! El servidor MCP lanza automáticamente Comet con depuración remota cuando sea necesario.

3. Usa en Claude Code

You: "Use Comet to research the top AI frameworks in 2025"
Claude: [delegates to Comet, monitors progress, returns results]

You: "Log into my GitHub and check my notifications"
Claude: [Comet handles the login flow and navigation]

Herramientas

Herramienta	Descripción
comet_connect	Conectar a Comet (se inicia automáticamente si es necesario)
comet_ask	Enviar una tarea y esperar respuesta
comet_poll	Comprobar el progreso de tareas de larga duración
comet_stop	Detener la tarea actual
comet_screenshot	Capturar la página actual
comet_mode	Cambiar modos: búsqueda, investigación, laboratorios, aprendizaje

Cómo funciona

Claude Code  →  MCP Server  →  CDP  →  Comet Browser  →  Perplexity AI
   (reasoning)     (bridge)                              (web browsing)

Claude envía objetivos de alto nivel ("investiga X", "inicia sesión en Y"). Comet determina los clics, desplazamientos y búsquedas. Los resultados fluyen de vuelta a Claude.

Requisitos

• Node.js 18+
• Perplexity Comet Browser
• Claude Code (o cualquier cliente MCP)
• Plataformas compatibles: macOS, Windows, WSL2

Soporte para Windows y WSL

Windows nativo

Funciona sin configuración adicional. Comet MCP detecta automáticamente Windows y lanza Comet desde su ubicación de instalación predeterminada.

WSL2 (Subsistema de Windows para Linux)

WSL2 requiere red en modo espejo para conectarse a Comet ejecutándose en Windows:

1. Habilita la red en modo espejo (configuración única):

   # Create/edit %USERPROFILE%\.wslconfig (Windows side)
   [wsl2]
   networkingMode=mirrored
   

2. Reinicia WSL:

   wsl --shutdown
   # Then reopen your WSL terminal
   

3. ¡Eso es todo! Comet MCP detecta automáticamente WSL y usa PowerShell para comunicarse con Windows.

Si la red en modo espejo no está disponible, verás un mensaje de error útil con instrucciones de configuración.

Ruta personalizada de Comet

Si Comet está instalado en una ubicación no estándar:

{
  "mcpServers": {
    "comet-bridge": {
      "command": "npx",
      "args": ["-y", "comet-mcp"],
      "env": {
        "COMET_PATH": "/path/to/your/Comet"
      }
    }
  }
}

Solución de problemas

"No se puede conectar a Comet"

• macOS: Asegúrate de que Comet esté instalado en /Applications/Comet.app
• Windows: Comet debería estar en %LOCALAPPDATA%\Perplexity\Comet\Application\
• Comprueba si el puerto 9222 está disponible

"WSL no puede conectarse a localhost de Windows"

• Habilita la red en modo espejo (consulta la sección de WSL anterior)
• O ejecuta Claude Code desde PowerShell de Windows en lugar de WSL

"Las herramientas no aparecen en Claude"

• Reinicia Claude Code después de cambios de configuración

Licencia

MIT

---

Reportar problemas · Contribuir