mcp-hydrolix

Servidor Hydrolix MCP

Un servidor MCP para Hydrolix.

Herramientas

• run_select_query
  • Ejecute consultas SQL en su clúster Hydrolix.
  • Entrada: sql (cadena): la consulta SQL a ejecutar.
  • Todas las consultas de Hydrolix se ejecutan con readonly = 1 para garantizar que sean seguras.
• list_databases
  • Enumere todas las bases de datos en su clúster Hydrolix.
• list_tables
  • Enumerar todas las tablas de una base de datos.
  • Entrada: database (cadena): el nombre de la base de datos.

Uso efectivo

Debido a la amplia variedad de arquitecturas LLM, no todos los modelos utilizarán las herramientas mencionadas de forma proactiva, y pocos las utilizarán eficazmente sin guía, incluso con las descripciones de herramientas cuidadosamente elaboradas que se proporcionan al modelo. Para obtener los mejores resultados de su modelo al utilizar el servidor Hydrolix MCP, recomendamos lo siguiente:

• Haga referencia a su base de datos Hydrolix por nombre y solicite el uso de herramientas en sus indicaciones (por ejemplo, "Usando herramientas MCP para acceder a mi base de datos Hydrolix, por favor...")
  • Esto anima al modelo a utilizar las herramientas MCP disponibles y minimiza las alucinaciones.
• Incluya rangos de tiempo en sus indicaciones (por ejemplo, "Entre el 5 de diciembre de 2023 y el 18 de enero de 2024, ...") y solicite específicamente que la salida se ordene por marca de tiempo.
  • Esto impulsa al modelo a escribir consultas más eficientes que aprovechan las optimizaciones de clave principal.

Configuración

El servidor Hydrolix MCP se configura mediante una entrada estándar de servidor MCP. Consulte la documentación de su cliente para obtener instrucciones específicas sobre dónde encontrar o declarar servidores MCP. A continuación se presenta un ejemplo de configuración con Claude Desktop.

La forma recomendada de iniciar el servidor Hydrolix MCP es a través del administrador de proyectos uv , que administrará la instalación de todas las demás dependencias en un entorno aislado.

Definición del servidor MCP (JSON):

Definición de servidor MCP (YAML):

Ejemplo de configuración (Claude Desktop)

1. Abra el archivo de configuración de Claude Desktop ubicado en:
   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • En Windows: %APPDATA%/Claude/claude_desktop_config.json
2. Agregue una entrada de servidor mcp-hydrolix al bloque de configuración mcpServers :

3. Actualice las definiciones de variables de entorno para que apunten a su clúster Hydrolix.
4. (Recomendado) Localice la entrada de comando para uv y reemplácela con la ruta absoluta del ejecutable uv . Esto garantiza que se use la versión correcta de uv al iniciar el servidor. Puede encontrar esta ruta con which uv o where.exe uv .
5. Reinicie Claude Desktop para aplicar los cambios. Si usa Windows, asegúrese de que Claude esté completamente cerrado cerrando el cliente con el icono de la bandeja del sistema.

Variables de entorno

Las siguientes variables se utilizan para configurar la conexión de Hydrolix. Estas variables pueden proporcionarse mediante el bloque de configuración de MCP (como se muestra arriba), un archivo .env o variables de entorno tradicionales.

Variables requeridas

• HYDROLIX_HOST : El nombre de host de su servidor Hydrolix
• HYDROLIX_USER : El nombre de usuario para la autenticación
• HYDROLIX_PASSWORD : La contraseña para la autenticación

Variables opcionales

• HYDROLIX_PORT : El número de puerto de su servidor Hydrolix
  • Predeterminado: 8088
  • Generalmente no es necesario configurarlo a menos que se utilice un puerto no estándar
• HYDROLIX_VERIFY : Habilitar/deshabilitar la verificación del certificado SSL
  • Valor predeterminado: "true"
  • Establezca en "false" para deshabilitar la verificación del certificado (no recomendado para producción)
• HYDROLIX_DATABASE : Base de datos predeterminada para utilizar
  • Predeterminado: Ninguno (usa el valor predeterminado del servidor)
  • Configure esto para conectarse automáticamente a una base de datos específica