Lightdash MCP Server

🚀 Lightdash-MCP-Server

Lightdash-MCP-Serverは、Lightdashへのアクセスを可能にするMCP（モデルコンテキストプロトコル）サーバーです。このサーバーは、標準化されたインターフェースを通じて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経由でのインストール

Smitheryを通じてClaude Desktop用のLightdash MCP Serverを自動インストールするには：

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

手動インストール

npm install lightdash-mcp-server

設定

• LIGHTDASH_API_KEY：あなたのLightdash PAT（個人アクセストークン）
• LIGHTDASH_API_URL：APIのベースURL

使用方法

1. MCPサーバーを起動する。

直接実行：

npx lightdash-mcp-server

または、Node.jsを使用してインストールされたモジュールを実行する。

2. あなたのMCP設定JSONファイルを編集し、以下の内容を追加する：

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

🔧 開発

利用可能なスクリプト

• npm run dev - 開発モードでサーバーを起動し、ホットリロードを有効にする
• npm run build - 本番環境用にプロジェクトをビルドする
• npm run start - 本番サーバーを起動する
• npm run lint - コードチェックを実行する（ESLintとPrettier）
• npm run fix - コードの問題を自動的に修正する
• npm run examples - サンプルスクリプトを実行する

貢献ガイド

1. このリポジトリをForkする
2. 機能ブランチを作成する
3. テストとコードチェックを実行する：npm run lint
4. 変更をコミットする
5. ブランチにプッシュする
6. Pull Requestを作成する