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 文件安全并从未提交到版本控制中。
• 在安全环境中运行此服务器。