dbt セマンティック レイヤー MCP サーバー

Claude Desktop やその他の互換性のある AI アシスタントを通じて dbt セマンティック レイヤーをシームレスにクエリするためのモデル コネクタ プレゼンター (MCP) サーバー。

dbt セマンティック レイヤーとは何ですか?

dbtセマンティックレイヤーは、dbtプロジェクト内で一度メトリクスを定義し、それをデータスタック全体で一貫して再利用できる強力な機能です。以下の機能を提供します。

• ビジネス指標の唯一の真実の情報源

• すべてのデータツールで一貫した指標定義

• すべてのチームメンバーが複雑な指標に簡単にアクセスできるようになります

Related MCP server: MCP Iceberg Catalog

このプロジェクトについて

この MCP サーバーは、AI アシスタント (Claude など) と dbt セマンティック レイヤー間のブリッジとして機能し、次のことが可能になります。

• 自然言語の会話を通じてメトリクスを直接照会する

• 利用可能な指標とその定義を調べる

• ディメンションの内訳とフィルターを使用してデータを分析する

• AIアシスタントインターフェース内で結果を視覚化する

特徴

• 🔍メトリック検出: dbt セマンティック レイヤーで利用可能なメトリックを参照および検索します

• 📊クエリ作成:自然言語によるセマンティッククエリの生成と実行

• 🧮データ分析：より深い洞察を得るために指標をフィルタリング、グループ化、並べ替える

• 📈結果の視覚化：クエリ結果をわかりやすい形式で表示します

前提条件

• セマンティック レイヤーが有効になっている dbt Cloud アカウント

• dbt CloudインスタンスへのAPIアクセス

• Node.js (v14以降)

インストール

Smithery経由（推奨）

最も簡単なインストール方法はSmitheryを使うことです:

npx -y @smithery/cli install @TommyBez/dbt-semantic-layer-mcp --client claude

使用法

インストールして構成したら、Claude Desktop から直接 dbt セマンティック レイヤーを操作できるようになります。

1. 利用可能なメトリックについて質問します。「dbt セマンティック レイヤーではどのようなメトリックが利用できますか?」

2. クエリ固有の指標: 「前四半期の月間収益を製品カテゴリ別に表示してください」

3. 傾向を分析する: 「ユーザー登録数の週ごとの増加率はどのくらいですか?」

トラブルシューティング

問題が発生した場合:

• API認証情報が正しいことを確認してください

• dbt Cloud プロジェクトでセマンティック レイヤーが有効になっていることを確認します。

• dbtプロジェクトでメトリックが適切に定義されていることを確認します

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• dbt セマンティック レイヤーを作成するためのdbt Labs

• MCP 展開プラットフォームのSmithery

• MCP開発パッケージ用のLiteMCP