Domo MCP Server

🚀 Domo MCP サーバー

Domo API に接続するモデルコンテキストプロトコル (MCP) サーバーです。Domo データセットのメタデータ取得や SQL クエリの実行が可能です。

✨ 主な機能

• Domo データセットに関するメタデータを取得します。
• Domo データセット上で SQL クエリを実行します。

📦 インストール

前提条件

• Python 3.11 以上
• 以下の内容を持つ Domo インスタンス:
  • 開発者アクセストークン
  • クエリ可能なデータセットへのアクセス権

セットアップ手順

1. このリポジトリをクローンします。
2. 仮想環境を作成してアクティブ化します（推奨）:

   python -m venv .venv
   source .venv/bin/activate  # Windows の場合: .venv\Scripts\activate
   

3. 依存関係をインストールします:

   pip install -r mcp requests dotenv
   

4. ルートディレクトリに .env ファイルを作成し、以下の変数を含めます:

   DOMO_HOST=your-domo-instance.domo.com
   DOMO_DEVELOPER_TOKEN=your-personal-access-token
   

5. 接続をテストします（オプションですが推奨）:

   python test_connection.py
   

Domo 開発者トークンの取得

これらの手順に従って アクセストークンを生成してください。

💻 使用例

基本的な使用法

サーバーの起動

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

python domo.py

インスペクターを使用したテスト

この MCP サーバーをインスペクターでテストするには、以下を実行します:

npx @modelcontextprotocol/inspector python3 domo.py

高度な使用法

利用可能な MCP ツール

以下の MCP ツールが利用可能です:

1. get_dataset_metadata(dataset_id: str) - データセットのメタデータを取得します。
2. get_dataset_schema(dataset_id: str) - データセットのスキーマを取得します。
3. query_dataset(dataset_id: str, query: str) - SQL クエリを使用してデータセットを照会します。
4. search_datasets(query: str) - 名前でデータセットを検索してその ID を取得します。

LLM との組み合わせでの使用例

MCP プロトコルをサポートする LLM と組み合わせて使用すると、このサーバーを通じて自然言語で Domo 環境と対話できます:

• "Example Sales データセット内で重要な優先度を持つ注文はいくつありますか？"
• "Customer Invoice データセットの所有者は誰ですか？"
• "過去 3 時間以内の Activity Log データセットのログを表示してください。"

📚 ドキュメント

トラブルシューティング

接続問題

• Domo ホストが正しく、https:// プレフィックスを含まないことを確認してください。
• 個人アクセストークンが必要な権限を持ち、期限が切れていないことを検証してください。
• 含まれているテストスクリプトを実行してください: python test_connection.py

セキュリティに関する注意事項

• あなたの Domo 開発者トークンはインスタンスへの直接アクセスを提供します。
• .env ファイルが安全で、バージョン管理システムにコミットされていないことを確認してください。
• このサーバーを安全な環境で実行してください。