Domo MCP 服务器

一个连接到 Domo API 的模型上下文协议 (MCP) 服务器。

功能

• 获取关于 Domo 数据集 (DataSet) 的元数据
• 在 Domo 数据集上运行 SQL 查询

前提条件

• Python 3.11+
• 具有以下条件的 Domo 实例：
  • 开发者访问令牌 (Developer access token)
  • 访问要查询的数据集的权限

设置

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

可用的 MCP 工具

以下 MCP 工具可用：

1. get_dataset_metadata(dataset_id: str) - 获取数据集的元数据
2. get_dataset_schema(dataset_id: str) - 获取数据集的模式 (schema)
3. query_dataset(dataset_id: str, query: str) - 使用 SQL 查询数据集
4. search_datasets(query: str) - 通过名称搜索数据集以获取其 ID

与 LLM 的示例用法

当与支持 MCP 协议的 LLM 一起使用时，此服务器可以实现与您的 Domo 环境的自然语言交互：

• "我的 Example Sales 数据集中有多少订单具有关键优先级？"
• "谁拥有 Customer Invoice 数据集？"
• "在我的 Activity Log 数据集中显示最近 3 小时的日志。"

故障排除

连接问题

• 确保您的 Domo 主机正确，并且不包含 https:// 前缀
• 验证您的个人访问令牌是否具有必要的权限并且未过期
• 运行包含的测试脚本：python test_connection.py

安全注意事项

• 您的 Domo 开发者令牌提供对您实例的直接访问
• 保护您的 .env 文件，并且永远不要将其提交到版本控制
• 在安全的环境中运行此服务器