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: Unity MCP Integration

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.