DX MCP Server

Consulta tus datos organizacionales en DX Data Cloud usando lenguaje natural.

GitHub
11
Prueba este MCPPatrocinado

Documentación

Servidor MCP de DX

¡Usa lenguaje natural para escribir y ejecutar consultas sobre los datos organizacionales en DX Data Cloud!

AI Query Interface with DX MCP Server

Acerca de

El Servidor MCP de DX es una herramienta basada en Python que permite a aplicaciones de IA, como Claude for Desktop y Cursor, interactuar con tu base de datos de DX Data Cloud. El servidor incluye herramientas para:

  • establecer una conexión con tu base de datos Postgres, permitiendo que la IA formule y ejecute consultas activamente en la base de datos
  • encontrar/utilizar contexto sobre tus entidades de software y sus relaciones y cuadros de mando mediante las herramientas de catálogo de DX

Aprende más sobre el Protocolo de Contexto de Modelo (MCP).

Nota: DX tiene la intención de que la CLI se convierta en la interfaz principal para agentes de IA y está invirtiendo en ella como la dirección a largo plazo más allá del servidor MCP. Ambas interfaces siguen siendo compatibles.

Demostración

https://github.com/user-attachments/assets/c6ce12a5-4562-4b44-b235-2d04871c3142

Primeros pasos

Hay dos formas de usar el Servidor MCP de DX:

  1. Alojamiento remoto (recomendado): Conéctate a nuestro servidor alojado en https://ai.getdx.com/mcp
  2. Alojamiento local: Ejecuta el servidor en tu máquina

Requisitos previos

  • Una cuenta de DX con acceso a Data Cloud

  • Para alojamiento remoto:

    • Un token de API de DX, generado en tu Configuración de cuenta de DX
      • Los usuarios administradores pueden crear un token de API de organización con permisos de lectura otorgados, y los usuarios no administradores pueden generar tokens de acceso personal para autenticarse con el servidor MCP.

  • Para alojamiento local:

    • Python 3.10 o superior
    • Tu URL de conexión a la base de datos (configurada en la página de configuración de usuarios de BD de DX)
    • Un token de API de DX, generado en tu Configuración de cuenta de DX
      • Los usuarios administradores pueden crear un token de API de organización con permisos de lectura otorgados, y los usuarios no administradores pueden generar tokens de acceso personal para autenticarse con el servidor MCP.

Opción 1: Alojamiento remoto (recomendado)

El servidor MCP alojado utiliza transporte HTTP transmisible y está disponible en https://ai.getdx.com/mcp. Esta opción no requiere instalación local; solo configura tu cliente de IA con el MCP usando transporte http y proporciona un token de API de DX válido.

Claude Code

Ejecuta este comando en tu terminal:

claude mcp add --transport http dx-mcp https://ai.getdx.com/mcp --header "Authorization: Bearer [YOUR_DX_API_TOKEN]"

Cursor

Agrega esta configuración a tu configuración de MCP (Cursor > Configuración > Configuración de Cursor > MCP):

{
  "mcpServers": {
    "dx-mcp": {
      "url": "https://ai.getdx.com/mcp",
      "headers": {
        "Authorization": "Bearer [YOUR_DX_API_TOKEN]"
      }
    }
  }
}

Opción 2: Instalación local

Si prefieres ejecutar el Servidor MCP de DX localmente, puedes instalarlo a través de PyPI o ejecutarlo desde el código fuente.

Método de instalación 1: Instalar desde PyPI

Instala el paquete usando pip:

pip install dx-mcp-server

Nota para usuarios de macOS: Si encuentras un error de "entorno gestionado externamente", usa pipx en su lugar:

pipx install dx-mcp-server

Método de instalación 2: Clonar desde el código fuente

Clona este repositorio para ejecutarlo desde el código fuente:

git clone https://github.com/get-dx/dx-mcp-server
cd dx-mcp-server

Configuración

Una vez instalado, configura tu cliente de IA con la configuración adecuada:

Claude Code

Ejecuta este comando en tu terminal (ajusta según tu método de instalación):

# If installed via pip/pipx
claude mcp add dx-mcp-server --env DB_URL=YOUR_DB_URL --env WEB_API_TOKEN=YOUR_DX_API_TOKEN -- $(which dx-mcp-server)

Claude for Desktop

Haz clic en Claude > Configuración > Desarrollador > Editar configuración y agrega:

Si instalaste con pip:

{
  "mcpServers": {
    "dx-mcp": {
      "command": "dx-mcp-server", 
      "args": ["run"],
      "env": {
        "DB_URL": "YOUR-DATABASE-URL",
        "WEB_API_TOKEN": "YOUR_DX_API_TOKEN"
      }
    }
  }
}

Si estás ejecutando desde el código fuente:

{
  "mcpServers": {
    "dx-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/dx-mcp-server", "run", "-m", "dx_mcp_server", "run"],
      "env": {
        "DB_URL": "YOUR-DATABASE-URL",
        "WEB_API_TOKEN": "YOUR-DX-API-TOKEN"
      }
    }
  }
}

Cursor

Haz clic en Cursor > Configuración > Configuración de Cursor > MCP > Agregar nuevo servidor MCP global y agrega:

Si instalaste con pip:

{
  "mcpServers": {
    "dx-mcp": {
      "command": "dx-mcp-server", 
      "args": ["run"],
      "env": {
        "DB_URL": "YOUR-DATABASE-URL",
        "WEB_API_TOKEN": "YOUR-DX-API-TOKEN"
      }
    }
  }
}

Si estás ejecutando desde el código fuente:

{
  "mcpServers": {
    "dx-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/dx-mcp-server", "run", "-m", "dx_mcp_server", "run"],
      "env": {
        "DB_URL": "YOUR-DATABASE-URL",
        "WEB_API_TOKEN": "YOUR-DX-API-TOKEN"
      }
    }
  }
}

Parámetros de configuración

  • DB_URL (obligatorio): Tu cadena de conexión Postgres de DX Data Cloud. Obtén esto desde la configuración de usuarios de BD de DX.
    • Formato: postgresql://username:password@host:port/database
  • WEB_API_TOKEN: Tu token de API de DX (ya sea un token de organización o un token de acceso personal). Esto habilita herramientas adicionales de catálogo y entidades. Encuéntralo en la configuración de tu cuenta de DX.

Uso

Después de guardar la configuración, reinicia tu cliente de IA. Deberías ver "dx-mcp" en los servidores MCP disponibles. Cuando hagas preguntas sobre tus datos o catálogo, la IA usará estas herramientas para consultar tu base de datos o acceder a las APIs web relevantes.

Solución de problemas

Problemas de resolución de rutas

El problema más común implica que el cliente MCP no encuentra el comando dx-mcp-server/uv, ya que las aplicaciones GUI no heredan las mismas variables de entorno PATH que la terminal. La solución es usar la ruta completa al ejecutable en la configuración json.

Para instalaciones con pip/pipx:

Encuentra la ruta completa a dx-mcp-server:

# Find the path on macOS/Linux
which dx-mcp-server

# Find the path on Windows (in Command Prompt)
where dx-mcp-server

Luego usa la ruta completa en tu configuración:

{
  "mcpServers": {
    "dx-mcp": {
      "command": "/full/path/to/dx-mcp-server",
      "args": ["run"],
      "env": {
        "DB_URL": "YOUR-DATABASE-URL",
        "WEB_API_TOKEN": "YOUR-DX-API-TOKEN"
      }
    }
  }
}

Para instalaciones desde el código fuente:

Encuentra la ruta completa a uv:

# Find the path on macOS/Linux
which uv

# Find the path on Windows (in Command Prompt)
where uv

Luego usa la ruta completa en tu configuración:

{
  "mcpServers": {
    "dx-mcp": {
      "command": "/full/path/to/uv",
      "args": ["--directory", "/absolute/path/to/dx-mcp-server", "run", "-m", "dx_mcp_server", "run"],
      "env": {
        "DB_URL": "YOUR-DATABASE-URL",
        "WEB_API_TOKEN": "YOUR-DX-API-TOKEN"
      }
    }
  }
}

Revisión de registros

Si sigues teniendo problemas:

  • Claude Desktop: Revisa los registros en:

    • macOS: ~/Library/Logs/Claude/
    • Windows: %APPDATA%\Claude\logs\

  • Cursor: Revisa los registros en:

    • macOS: ~/Library/Application Support/Cursor/logs/[SESSION_ID]
    • Windows: %APPDATA%\Cursor\logs\[SESSION_ID]

Los registros mostrarán mensajes de advertencia y error al iniciar o ejecutar el servidor MCP.