Hex API MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Servidor MCP hex-mcp

Un servidor MCP para Hex que implementa las siguientes herramientas:

  • list_hex_projects : Lista los proyectos hexadecimales disponibles
  • search_hex_projects : Busca proyectos hexadecimales por patrón
  • get_hex_project : Obtener información detallada sobre un proyecto específico
  • get_hex_run_status : Verifica el estado de la ejecución de un proyecto
  • get_hex_project_runs : Obtener el historial de ejecuciones del proyecto
  • run_hex_project : Ejecutar un proyecto hexadecimal
  • cancel_hex_run : Cancelar un proyecto en ejecución

Instalación

El uso de uv es la forma recomendada de instalar hex-mcp:

uv add hex-mcp

O usando pip:

pip install hex-mcp

Para confirmar que funciona, puedes ejecutar:

hex-mcp --version

Configuración

Usando el comando config (recomendado)

La forma más fácil de configurar hex-mcp es usando el comando config y pasando su clave API y URL API (opcional y predeterminada es https://app.hex.tech/api/v1 ):

hex-mcp config --api-key "your_hex_api_key" --api-url "https://app.hex.tech/api/v1"

[!NOTA] Esto guarda su configuración en un archivo en su directorio de inicio (por ejemplo, ~/.hex-mcp/config.yml ), haciéndolo disponible para todas las invocaciones de hex-mcp.

Uso de variables de entorno

Alternativamente, el servidor Hex MCP se puede configurar con variables de entorno:

  • HEX_API_KEY : Su clave API hexadecimal
  • HEX_API_URL : La URL base de la API hexadecimal

Al configurar las variables de entorno para servidores MCP, estas deben ser globales para que Cursor las recoja o utilizar el indicador --env-file de uv al invocar el servidor.

Uso con cursor

Cursor permite que los agentes de IA interactúen con Hex mediante el protocolo MCP. Siga estos pasos para configurar y usar hex-mcp con Cursor. Puede crear un archivo .cursor/mcp.json en la raíz del proyecto con el siguiente contenido:

{ "mcpServers": { "hex-mcp": { "command": "uv", "args": ["run", "hex-mcp", "run"] } } }

Alternativamente, puedes usar el comando hex-mcp directamente si está en tu PATH:

{ "mcpServers": { "hex-mcp": { "command": "hex-mcp", "args": ["run"] } } }

Una vez que esté en funcionamiento, puedes usarlo en Cursor iniciando una nueva conversación de IA (Agente) y pedirle que enumere o ejecute un proyecto Hex.

[!IMPORTANTE] El servidor MCP y la CLI aún están en desarrollo y están sujetos a cambios importantes.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor que permite a los asistentes de IA acceder, ver, ejecutar y administrar proyectos Hex a través de una interfaz estandarizada.

  1. Installation
    1. Configuration
      1. Using the config command (recommended)
      2. Using environment variables
    2. Using with Cursor
      ID: 0p1ppp85i7