Syucream Lightdash MCP Server

LightdashにMCPプロトコル互換インターフェースを提供するサービスで、AIアシスタントが標準化された方法でLightdashデータにアクセスできるようにします。

研究とデータ開発者ツール #データ可視化 #APIゲートウェイ #AI統合 Local .TypeScript

rating : 2 points

downloads : 8

update time : 2025-04-28

Lightdash MCPサーバーとは？

Lightdash MCPサーバーは、Model Context Protocol（MCP）に基づくミドルウェアサービスで、AIアシスタントとLightdashデータ分析プラットフォームの間の橋渡し役を果たします。標準化されたインターフェースを通じて、AIはLightdash内のプロジェクト、チャート、ダッシュボードなどのデータ分析コンテンツを照会および操作できます。

Lightdash MCPサーバーの使用方法は？

Node.jsパッケージをインストールし、APIキーを設定するだけで、MCPサービスエンドポイントを起動できます。AIアシスタントは、標準MCPプロトコルを通じてあなたのLightdashデータとやり取りできます。

適用シナリオ

AIアシスタントを通じてデータ分析結果を照会したり、レポートを自動生成したり、ビジネス指標とやり取りする必要があるシナリオに適しています。特に、データアナリストやビジネス担当者が自然言語でデータプラットフォームとやり取りするのに最適です。

主な機能

プロジェクトリストLightdash組織内のすべてのプロジェクトリストを取得します。

プロジェクト詳細特定のプロジェクトの詳細情報を表示します。

スペースリストプロジェクト内のすべてのスペースをリストします。

チャートリストプロジェクト内のすべてのチャートを取得します。

ダッシュボードリストプロジェクト内のすべてのダッシュボードをリストします。

カスタム指標プロジェクトのカスタムビジネス指標を取得します。

データカタログプロジェクトのデータカタログ情報にアクセスします。

指標カタログプロジェクトの指標カタログを取得します。

チャートコード化チャート定義をコード形式で取得します。

ダッシュボードコード化ダッシュボード定義をコード形式で取得します。

利点と制限

利点

標準化されたインターフェース：MCPプロトコルを通じて統一されたAIアクセス方法を提供します。

機能が充実：Lightdashの主要なデータオブジェクトと操作を網羅しています。

統合が容易：簡単なインストールと設定プロセスです。

コード化された出力：チャートとダッシュボードの定義をコード形式で取得できます。

制限

Lightdash APIアクセス権が必要です。

現在はLightdashプラットフォームのみをサポートしています。

一部の高度な機能には特定のLightdashバージョンが必要な場合があります。

使用方法

Node.js環境をインストールする

システムにNode.js 16以上がインストールされていることを確認してください。

サービスパッケージをインストールする

npmを通じてlightdash - mcp - serverをインストールします。

APIキーを設定する

.envファイルを作成し、Lightdash APIの認証情報を設定します。

サービスを起動する

サービスを実行し、MCPリクエストを待機します。

使用例

販売ダッシュボードを取得するAIアシスタントがMCPプロトコルを通じて最新の販売ダッシュボードデータを取得します。

プロジェクト指標を比較する2つのプロジェクトの主要ビジネス指標を比較します。

チャート定義をエクスポートするバージョン管理のためにチャート定義をコード形式で取得します。

よくある質問

Lightdash APIキーを取得する方法は？

サービスはデフォルトでどのポートで動作しますか？

自社管理のLightdashインスタンスをサポートしていますか？

利用可能なAPIエンドポイントを確認する方法は？

🚀 lightdash-mcp-server

MCP（モデルコンテキストプロトコル）をサポートするサーバーで、Lightdashに接続します。

このサーバーは、Lightdash APIと互換性のあるMCPアクセス権を提供し、AIアシスタントが標準化されたインターフェースを通じてLightdashデータとやり取りできるようにします。

✨ 主な機能

利用可能なツール：

list_projects - 組織内のすべてのプロジェクトをリストする
get_project - 特定のプロジェクトの詳細情報を取得する
list_spaces - プロジェクト内のすべてのスペースをリストする
list_charts - プロジェクト内のすべてのチャートをリストする
list_dashboards - プロジェクト内のすべてのダッシュボードをリストする
get_custom_metrics - プロジェクト内のカスタムメトリクスを取得する
get_catalog - プロジェクトのカタログ情報を取得する
get_metrics_catalog - プロジェクトのメトリクスカタログを取得する
get_charts_as_code - チャートをコード形式で取得する
get_dashboards_as_code - ダッシュボードをコード形式で取得する

🚀 クイックスタート

📦 インストール

npm install lightdash-mcp-server

設定

Lightdash APIの認証情報を含む .env ファイルを作成します。

LIGHTDASH_API_KEY=your_api_key
LIGHTDASH_API_URL=https://app.lightdash.cloud/api/v1  # または独自のLightdashインスタンスのURL

💻 使用例

基本的な使用法

MCPサーバーを起動します。

npx lightdash-mcp-server

サンプルの使用方法については、examples ディレクトリを参照してください。サンプルを実行するには：

# 必要な環境変数を設定する
export EXAMPLES_CLIENT_LIGHTDASH_API_KEY=your_api_key
export EXAMPLES_CLIENT_LIGHTDASH_PROJECT_UUID=your_project_uuid

# サンプルを実行する
npm run examples