LightdashにアクセスするMCP(Model Context Protocol)サーバー。

このサーバーは、Lightdash の API への MCP 互換アクセスを提供し、AI アシスタントが標準インターフェイスを介して Lightdash データをやり取りできるようにします。

##特徴

利用可能なツール:

• [list_projects - Lightdash組織のすべてのプロジェクトをリスト
• [get_project - 特定のプロジェクトの詳細を取得する
• [list_spaces - プロジェクト内のすべてのスペースを一覧表示
• [list_charts - プロジェクト内のすべてのチャートを一覧表示
• [list_dashboards - プロジェクト内のすべてのダッシュボードを一覧表示
• [get_custom_metrics - プロジェクトのカスタムメトリックを取得する
• [get_catalog - プロジェクトのカタログを入手
• [get_metrics_catalog - プロジェクトのメトリックカタログを取得する
• [get_charts_as_code - プロジェクトのコードとしてチャートを取得する
• [get_dashboards_as_code - プロジェクトのコードとしてダッシュボードを取得する

クイックスタート

インストール

###Smithery によるインストール

スミサリーを介して自動的にClaudeデスクトップ用のLightdash MCP Serverをインストールするには:

マニュアルインストール

設定

• [LIGHTDASH_API_KEY: あなたのライトダッシュPAT
• [LIGHTDASH_API_URL: APIベースURL

使用法

lightdash-mcp-server は 2 つのトランスポートモードをサポートしています。Stdio (デフォルト) とHTTP.

lightdash-mcp-server

A MCP(Model Context Protocol) server that accesses to Lightdash.

This server provides MCP-compatible access to Lightdash’s API, allowing AI assistants to interact with your Lightdash data through a standardized interface.

Features

Available tools:

• list_projects - List all projects in the Lightdash organization
• get_project - Get details of a specific project
• list_spaces - List all spaces in a project
• list_charts - List all charts in a project
• list_dashboards - List all dashboards in a project
• get_custom_metrics - Get custom metrics for a project
• get_catalog - Get catalog for a project
• get_metrics_catalog - Get metrics catalog for a project
• get_charts_as_code - Get charts as code for a project
• get_dashboards_as_code - Get dashboards as code for a project

Quick Start

Installation

Installing via Smithery

To install Lightdash MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

npm install lightdash-mcp-server

Configuration

• LIGHTDASH_API_KEY: Your Lightdash PAT
• LIGHTDASH_API_URL: The API base URL

Usage

The lightdash-mcp-server supports two transport modes: Stdio (default) and HTTP.

Stdio Transport (Default)

1. Start the MCP server:

npx lightdash-mcp-server

2. Edit your MCP configuration json:

...
    "lightdash": {
      "command": "npx",
      "args": [
        "-y",
        "lightdash-mcp-server"
      ],
      "env": {
        "LIGHTDASH_API_KEY": "",
        "LIGHTDASH_API_URL": "https://"
      }
    },
...

HTTP Transport (Streamable HTTP)

1. Start the MCP server in HTTP mode:

npx lightdash-mcp-server -port 8080

This starts the server using StreamableHTTPServerTransport, making it accessible via HTTP at http://localhost:8080/mcp.

2. Configure your MCP client to connect via HTTP:

For Claude Desktop and other MCP clients:

Edit your MCP configuration json to use the url field instead of command and args:

...
    "lightdash": {
      "url": "http://localhost:8080/mcp"
    },
...

For programmatic access:

Use the streamable HTTP client transport:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';