Domo MCP Server

🚀 Domo MCP 服務器

Domo MCP 服務器是一個可連接到 Domo API 的模型上下文協議 (MCP) 服務器，它能獲取 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

你可以使用 inspector 測試此 MCP 服務器，運行：

npx @modelcontextprotocol/inspector python3 domo.py

✨ 主要特性

• 獲取有關 Domo 數據集的元數據。
• 在 Domo 數據集上運行 SQL 查詢。

💻 使用示例

基礎用法

當與支持 MCP 協議的 LLM 結合使用時，此服務器使你能夠通過自然語言與你的 Domo 環境交互，例如：

• "我的 Example Sales 數據集中有多少個具有關鍵優先級的訂單？"
• "誰擁有 Customer Invoice 數據集？"
• "顯示過去 3 小時內的 Activity Log 數據集日誌。"

高級用法

以下是可用的 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

📚 詳細文檔

故障排除

連接問題

• 確保 Domo 主機正確且不包含 https:// 前綴。
• 驗證個人訪問令牌具有必要的權限且未過期。
• 運行 included 測試腳本：python test_connection.py

安全注意事項

• 你的 Domo 開發者令牌提供對實例的直接訪問。
• 確保 .env 文件安全並從未提交到版本控制中。
• 在安全環境中運行此服務器。