Tommybez Dbt Semantic Layer MCP Server

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

このプロジェクトは、Claude Desktopやその他の互換性のあるAIアシスタントを通じて、dbtセマンティックレイヤーをシームレスにクエリできるModel-Connector-Presenter (MCP) サーバーです。

🚀 クイックスタート

このMCPサーバーは、AIアシスタント（Claudeなど）とdbtセマンティックレイヤーの間の橋渡しとして機能し、自然言語での会話を通じて直接指標を照会したり、利用可能な指標を閲覧・検索したり、データ分析を行ったり、結果を可視化したりすることができます。

✨ 主な機能

• 🔍 指標発見：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. トレンドを分析する：「ユーザー登録数の週間対比成長率は何ですか？」

📚 ドキュメント

何がdbtセマンティックレイヤーですか？

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

• ビジネス指標の唯一の信頼できる情報源
• データツール間で一貫した指標定義
• すべてのチームメンバーが使用しやすいように複雑な指標を簡素化

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

このMCPサーバーは、AIアシスタント（Claudeなど）とdbtセマンティックレイヤーの間の橋渡しとして機能し、以下のことができます。

• 自然言語対話を通じて直接指標を照会する
• 利用可能な指標とその定義を閲覧および検索する
• フィルタリング、グループ化、ソートによるデータ分析
• AIアシスタントのインターフェイスで結果を可視化する

トラブルシューティング

問題が発生した場合：

• API資格情報が正しいことを確認してください。
• dbt Cloudプロジェクトでセマンティックレイヤーが有効になっていることを確認してください。
• dbtプロジェクトで指標が正しく定義されていることを確認してください。

貢献

貢献を歓迎します！自由にPull Requestを送信してください。

謝辞

• dbt Labs はdbtセマンティックレイヤーを作成しました。
• Smithery はMCPデプロイメントプラットフォームを提供しました。
• LiteMCP はMCP開発パッケージを提供しました。

📄 ライセンス

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