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

Related MCP server: Integrator MCP Server

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.