Agente Hermes + MCP Sin Residuos: Construye un Asistente de IA Consciente de la Web

TL;DR:

• El Agente Hermes puede cargar Scrapeless como un servidor MCP local de stdio y descubrir sus herramientas web al inicio.
• Una configuración verificada expuso ocho herramientas seleccionadas a Hermes mientras que la prueba de conexión descubrió veinticuatro herramientas en el servidor.
• Las listas de herramientas permiten que la superficie visible del agente se concentre en búsqueda, extracción y un flujo de trabajo de navegador limitado.
• Un apretón de manos exitoso de MCP prueba la conectividad y el descubrimiento del esquema; se requiere una clave válida de Scrapeless para llamadas web en vivo.

El Agente Hermes ya sabe cómo razonar sobre herramientas. La pregunta de integración útil es más estrecha: ¿cómo puede obtener evidencia web actual sin enterrar la automatización del navegador, la búsqueda y la lógica de extracción dentro del propio agente?

MCP proporciona el límite. Hermes actúa como el cliente. Scrapeless funciona como el servidor de herramientas. El modelo ve un conjunto filtrado de operaciones tipificadas, y las credenciales permanecen en el entorno del servidor en lugar de dentro del aviso.

Lo que puedes hacer con Hermes Agent y Scrapeless MCP

La conexión soporta un conjunto práctico de trabajos de agentes conscientes de la web:

• buscar en Google y devolver resultados estructurados al agente;
• extraer contenido de la página como Markdown para investigación o resumen;
• crear una sesión de navegador en la nube para páginas con mucho JavaScript;
• navegar, inspeccionar elementos interactivos, hacer clic, escribir y leer texto visible;
• mantener el rastro de la operación web separado de la interpretación del modelo.

Hermes registra herramientas de MCP junto a sus herramientas nativas. Su guía de MCP documenta servidores locales de stdio y HTTP remotos, descubrimiento automático y filtrado por servidor. Eso significa que no se requiere ningún plugin personalizado de Hermes para un servidor que ya habla MCP.

¿Por qué usar el Servidor MCP de Scrapeless?

Una solicitud HTTP normal funciona para páginas estáticas. Un agente que investiga la web en vivo pronto se encuentra con páginas que dependen de JavaScript, controles interactivos, ubicación o una sesión mantenida. El servidor Scrapeless agrupa la búsqueda, extracción, rastreo y acciones del navegador detrás de una conexión MCP.

El repositorio oficial del Servidor MCP de Scrapeless documenta tanto los transportes HTTP de stdio como los de Streamable. Esta guía usa stdio porque le da a Hermes un proceso hijo local con un ciclo de vida claro y una pequeña huella de configuración.

Para una conexión directa del navegador a través de CDP en lugar de MCP, utiliza la guía separada de Hermes Agent y Scraping Browser. Los dos enfoques resuelven diferentes problemas de integración: CDP expone una conexión de navegador; MCP expone herramientas tipificadas que Hermes puede descubrir y filtrar.

Prerrequisitos

Prepara esto antes de editar la configuración de Hermes:

• Git, Node.js y npx en la máquina que ejecuta Hermes;
• Python en el rango de versiones soportadas por la versión actual de Hermes;
• una cuenta de Scrapeless y una clave de API;
• una terminal donde hermes se resuelva a la instalación prevista.

Mantén la clave de API fuera de Markdown, historial de shell y avisos de agente. La documentación de Scrapeless explica dónde crear y gestionar credenciales.

Conectar Hermes Agent a Scrapeless MCP

Instalar Hermes con soporte MCP

El instalador estándar de Hermes ya incluye soporte para MCP. Para una instalación de fuente aislada, la siguiente secuencia es útil porque la fija en un directorio.

git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
python3.12 -m venv .venv
./.venv/bin/pip install -e '.[mcp]'
./.venv/bin/hermes --version

Esta secuencia se ejecutó contra Hermes Agent v0.20.5 con Python 3.12.13. La guía de instalación oficial sigue siendo el camino preferido para una instalación normal de usuario final porque gestiona el lanzador y las dependencias de soporte.

Configurar el servidor stdio

Agrega una entrada scrapeless debajo de mcp_servers en el config.yaml activo de Hermes. Reemplaza el valor de prerrequisitos con una clave real en el entorno antes de iniciar Hermes.

mcp_servers:
  scrapeless:
    command: npx
    args: ["-y", "scrapeless-mcp-server"]
    env:
      SCRAPELESS_KEY: "${SCRAPELESS_KEY}"
    enabled: true
    tools:
      include:
        - google_search
        - scrape_markdown
        - browser_create
        - browser_goto
        - browser_snapshot
        - browser_click
        - browser_get_text
        - browser_close
      resources: false
      prompts: false

Las claves command, args, env y tools siguen la referencia de configuración de MCP de Hermes. La lista de permitidos es deliberada. Le da a un asistente de investigación búsqueda, extracción legible y un bucle de navegador limitado sin exponer cada operación disponible.

Comienza a Rastrear con Scrapeless

¡Activa tu flujo de trabajo de web scraping y automatización con Scrapeless!
Regístrate hoy y recibe $5 en crédito gratuito — sin necesidad de tarjeta de crédito.
Reclama tu crédito gratuito ahora en el Scrapeless Dashboard.

Verifica la conexión y el descubrimiento de herramientas

Hermes incluye una prueba de conexión que inicia el servidor configurado, realiza el apretón de manos de MCP y lista las herramientas descubiertas.

hermes mcp list
hermes mcp test scrapeless

La ejecución verificada reportó este resumen:

scrapeless   node ...   8 selected   enabled
Connected
Tools discovered: 24

Los dos recuentos describen diferentes superficies. “Ocho seleccionados” es la lista de allowlist almacenada en la configuración de Hermes. “Veinticuatro descubiertos” es el catálogo completo de herramientas devuelto durante la prueba de conexión. En tiempo de ejecución, la allowlist es la superficie destinada para el modelo.

Los nombres de las herramientas aparecen en Hermes con un espacio de nombres de MCP que identifica el servidor y la herramienta nativa. El formato exacto es manejado por Hermes; los nombres nativos del servidor en tools.include permanecen google_search, scrape_markdown, y los nombres de las operaciones del navegador. El intercambio de protocolos subyacentes sigue la especificación del Protocolo de Contexto de Modelo.

Si la configuración cambia mientras Hermes está en ejecución, usa /reload-mcp dentro de la sesión. La prueba de conexión y la prueba de credenciales son separadas. El apretón de manos puede tener éxito con esquemas válidos incluso cuando una llamada web posterior no puede autenticar, así que haz una búsqueda de solo lectura después de cargar la clave real.

Cómo usar esto: solicita a tu agente

Los mejores mensajes describen el estándar de evidencia y el camino de herramienta permitido, no una secuencia frágil de clics.

Mensaje que puedes pegar

Busca en la web los requisitos de instalación actuales del proyecto nombrado. Abre el resultado de la documentación oficial, extrae la sección relevante como Markdown y devuelve una lista de verificación corta. Cita la URL de la fuente y distingue los hechos documentados de tu inferencia. No uses herramientas con capacidad de escritura.

Este mensaje le da a Hermes espacio para seleccionar herramientas mientras preserva un resultado verificable. La búsqueda descubre la página oficial. La extracción de Markdown proporciona evidencia legible. La respuesta lleva la URL y etiqueta cualquier inferencia.

Un mensaje respaldado por el navegador

Abre la página pública del producto, inspecciona la estructura de la página interactiva y reporta los nombres de los planes visibles y sus unidades mostradas. No inicies sesión, no envíes formularios ni hagas clic en controles de compra. Incluye la URL final de la página y cita solo el texto mínimo necesario para soportar la tabla.

Esta versión establece restricciones negativas alrededor de acciones consecuentes. La allowlist también ayuda: ninguna herramienta de envío de formularios es visible a menos que las operaciones del navegador elegidas puedan expresarlo, y el mensaje prohíbe la acción.

La superficie de herramientas de Scrapeless MCP

La construcción del servidor verificado devolvió veinticuatro herramientas agrupadas en cuatro familias útiles:

No expongas el catálogo completo por costumbre. Un agente de redacción de informes puede necesitar solo búsqueda y extracción de Markdown. Una tarea de navegador necesita un ciclo de vida de sesión y acciones de página. Mantén perfiles de Hermes separados o entradas de servidor separadas cuando esos conjuntos de permisos difieran materialmente.

La superficie de agentes de Scrapeless AI proporciona el contexto del producto, y precios ayuda a mapear las operaciones web esperadas a un plan de cuenta.

Lo que obtienes de regreso

Los resultados de herramientas MCP permanecen como mensajes estructurados en lugar de estado oculto del navegador. Una búsqueda puede devolver registros de resultados; la extracción puede devolver Markdown; las instantáneas del navegador pueden devolver descripciones de elementos adecuadas para la próxima decisión del modelo. Hermes luego coloca el resultado seleccionado en su contexto de tarea.

Esa separación mejora el diagnóstico. “El servidor no pudo iniciar”, “el descubrimiento de herramientas falló”, “credenciales rechazadas” y “la página no devolvió contenido útil” son eventos diferentes. El arnés puede reportar el correcto en lugar de convertir cada fracaso en una vaga disculpa del modelo.

Conclusión

Hermes Agent y Scrapeless MCP encajan juntos en un límite limpio: Hermes se encarga del razonamiento y la orquestación; el servidor MCP posee operaciones web tipadas. El camino verificado es instalar, configurar un servidor stdio, aplicar una lista de permisos reducida, probar la búsqueda y hacer una llamada restringida por credenciales de solo lectura.

¿Listo para construir un agente Hermes consciente de la web?

Únete a nuestra comunidad para reclamar un plan gratuito y conectarte con desarrolladores que construyen flujos de trabajo de investigación de agentes: Discord · Telegram.

Regístrate en app.scrapeless.com y conecta Hermes a la superficie de herramientas web útiles más pequeñas.

Preguntas frecuentes

P: ¿Soporta Hermes Agent servidores MCP?

Sí. Hermes Agent soporta servidores MCP locales stdio y remotos HTTP, descubre sus herramientas al inicio y puede filtrar las herramientas visibles por servidor.

P: ¿Qué variable de entorno utiliza el servidor stdio de Scrapeless?

La configuración stdio documentada utiliza SCRAPELESS_KEY. Colócalo en el entorno del servidor y mantén el valor fuera de los prompts y de los archivos de configuración comprometidos.

P: ¿Por qué la prueba de conexión muestra más herramientas que la lista de permisos?

La prueba de conexión informa sobre el catálogo descubierto del servidor, mientras que la lista de permisos define el subconjunto destinado para el modelo. En la configuración verificada, el servidor devolvió veinticuatro esquemas de herramientas y la configuración seleccionó ocho.

P: ¿Una conexión MCP exitosa prueba que la clave API funciona?

No. Un apretón de manos exitoso prueba que Hermes inició el servidor y descubrió sus esquemas. Ejecuta una operación web de solo lectura después de cargar la clave real para verificar la autenticación del servicio.

P: ¿Debería habilitarse cada herramienta MCP de Scrapeless?

No. Habilita solo las operaciones requeridas por el trabajo del agente. Conjuntos de herramientas más pequeños reducen la ambigüedad de selección y limitan el efecto de una acción equivocada.

P: ¿Puede Hermes usar Scrapeless sin un marco de agente AI?

Hermes es en sí mismo el tiempo de ejecución del agente en esta configuración. Se conecta directamente al servidor MCP de Scrapeless, por lo que no se requiere ningún marco adicional de agente.

P: ¿Puede la configuración usar HTTP en lugar de stdio?

Sí. Ambos productos documentan conexiones MCP habilitadas para HTTP. Stdio es conveniente para un proceso hijo local; HTTP remoto es útil cuando el ciclo de vida del servidor y las credenciales se gestionan centralmente.

P: ¿MCP anula las reglas de acceso a sitios web?

No. MCP define cómo se comunican el cliente y el servidor de herramientas. El agente aún necesita permiso para acceder al objetivo, debe utilizar datos públicos o autorizados, y debe seguir los términos y leyes aplicables.