servidor lightdash-mcp

Un servidor MCP (Protocolo de contexto de modelo) que accede a Lightdash .

Este servidor proporciona acceso compatible con MCP a la API de Lightdash, lo que permite que los asistentes de IA interactúen con sus datos de Lightdash a través de una interfaz estandarizada.

Características

Herramientas disponibles:

• list_projects - Lista todos los proyectos en la organización Lightdash

• get_project - Obtener detalles de un proyecto específico

• list_spaces - Lista todos los espacios en un proyecto

• list_charts - Lista todos los gráficos de un proyecto

• list_dashboards - Lista todos los paneles de un proyecto

• get_custom_metrics - Obtener métricas personalizadas para un proyecto

• get_catalog - Obtener el catálogo de un proyecto

• get_metrics_catalog - Obtener el catálogo de métricas de un proyecto

• get_charts_as_code - Obtener gráficos como código para un proyecto

• get_dashboards_as_code - Obtener paneles como código para un proyecto

Related MCP server: Astro Docs MCP Server

Inicio rápido

Instalación

Instalación mediante herrería

Para instalar Lightdash MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install lightdash-mcp-server --client claude

Instalación manual

npm install lightdash-mcp-server

Configuración

Cree un archivo .env con sus credenciales de API de Lightdash:

LIGHTDASH_API_KEY=your_api_key
LIGHTDASH_API_URL=https://app.lightdash.cloud  # or your custom Lightdash instance URL

Uso

1. Inicie el servidor MCP.

Directamente:

npx lightdash-mcp-server

O bien, ejecute el módulo instalado con el nodo.

2. Edite su json de configuración de MCP:

...
    "lightdash": {
      "command": "npx",
      "args": [
        "-y",
        "lightdash-mcp-server"
      ],
      "env": {
        "LIGHTDASH_API_KEY": "<your PAT>",
        "LIGHTDASH_API_URL": "https://<your base url>"
      }
    },
...

Desarrollo

Scripts disponibles

• npm run dev - Inicia el servidor en modo de desarrollo con recarga en caliente

• npm run build : compila el proyecto para producción

• npm run start : inicia el servidor de producción

• npm run lint : ejecuta comprobaciones de linting (ESLint y Prettier)

• npm run fix : corrige automáticamente los problemas de pelusa

• npm run examples : ejecutar los scripts de ejemplo

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones

3. Ejecutar pruebas y linting: npm run lint

4. Confirme sus cambios

5. Empujar hacia la rama

6. Crear una solicitud de extracción