Servidor MCP de CLI H3

Un servidor MCP que permite a los asistentes de IA y LLM interactuar con la API Horizon3.ai utilizando la herramienta oficial h3-cli .

¿Qué es esto?

Este servidor MCP expone toda la potencia de h3-cli a su asistente de programación de IA (Claude, Cursor, VS Code, etc.). Permite:

Programación y ejecución de pruebas de penetración
Consulta de resultados de pruebas de penetración, debilidades, impactos, hosts, credenciales y más
Automatizar los flujos de trabajo y los informes de seguridad
Todo mediante lenguaje natural y herramientas LLM

Nota: Debe tener instalado y autenticado h3-cli en su sistema. Este servidor es un contenedor ligero y no administra sus claves API ni la instalación de CLI.

Copiar y pegar rápidamente: agregar a su cliente MCP

Agregue esto a la configuración de su cliente MCP (por ejemplo, Cursor, Claude Desktop, Windsurf, etc.):

{
  "mcpServers": {
    "h3": {
      "command": "uvx",
      "args": ["horizon3ai/h3-cli-mcp"]
    }
  }
}

No es necesario clonar ni crear este repositorio manualmente: uvx buscará y ejecutará la última versión automáticamente.
Para uso avanzado, consulte a continuación.

Características

Acceso completo a la API h3-cli : todo lo que puede hacer con la CLI, puede hacerlo a través de las herramientas LLM.
Documentación de GraphQL : obtenga documentos actualizados para todas las consultas y mutaciones disponibles.
Validación de parámetros : mensajes de error claros y ejemplos para todas las entradas de la herramienta.
Plantillas de indicaciones : guía incorporada para paginación, pivotes y flujos de trabajo comunes.
Funciona con cualquier cliente compatible con MCP : Claude, Cursor, Windsurf, VS Code y más.

Herramientas proporcionadas

Nombre de la herramienta	Descripción
`run_h3_command`	Ejecute cualquier comando h3-cli y devuelva la salida.
`fetch_graphql_docs`	Obtenga esquemas/documentaciones de GraphQL para cualquier consulta, mutación o tipo.
`run_graphql_request`	Ejecute una consulta GraphQL sin procesar con variables y obtenga el resultado.
`health_check`	Verifique la instalación de h3-cli y la conectividad API.

Consulte la interfaz de usuario de descubrimiento de herramientas de su cliente para obtener detalles completos de los parámetros y ejemplos.

Uso con VS Code, Cursor, Claude Desktop, etc.

VS Code : agregue la configuración anterior a su .vscode/mcp.json o Configuración de usuario (JSON).
Cursor : agréguelo a ~/.cursor/mcp.json o al .cursor/mcp.json de su proyecto.
Claude Desktop : agregar a claude_desktop_config.json .
Windsurf : agréguelo a su archivo de configuración MCP de Windsurf.

Para obtener más detalles, consulte la documentación de su cliente sobre la configuración del servidor MCP.

Solución de problemas

Si ve errores sobre h3 no encontrado, asegúrese de haber instalado y autenticado h3-cli (ver a continuación).
Si ve errores de autenticación, verifique nuevamente su clave API en la CLI.
Para obtener más ayuda, consulte la guía de configuración oficial de h3-cli .

Licencia

Licencia MIT

1. Instalar h3-cli

git clone https://github.com/horizon3ai/h3-cli
cd h3-cli
bash install.sh your-api-key-here

Obtenga su clave API del Portal Horizon3.ai en Usuario → Configuración de la cuenta.
El script de instalación le solicitará que actualice su perfil de shell. Siga las instrucciones y reinicie su terminal.

2. Pruebe su instalación de h3-cli

h3

Debería ver el texto de ayuda de h3-cli.

3. Verifique su conexión API

h3 hello-world

Deberías ver una respuesta como:

{ "data": { "hello": "world!" } }

H3 CLI MCP Server

Integrations