Domotz MCP Server

Claude的Domotz MCP服务器

使用模型上下文协议（MCP）将Claude AI连接到您的Domotz网络监控平台。这种集成使Claude可以访问 10类工具，涵盖133项API行动，启用有关网络基础设施的自然语言查询。

这有什么作用

使用此MCP服务器，您可以向Claude询问以下问题：

• “显示网络上当前脱机的所有设备”
• “过去一个月我的核心交换机的正常运行时间历史记录是什么？”
• “列出所有收集器及其连接状态”
• “是否存在任何活动的IP冲突？”

Claude将您的自然语言请求转换为Domotz API调用，并以可读的格式显示结果。

______________________________________________________________________

先决条件

在开始之前，请确保您已经：

1. Domotz账户 启用API访问
2. 克劳德桌面版 已安装(在这里下载)
3. Node.js 18+ 安装在您的系统上
4. 您的Domotz API密钥 （请参阅下文了解如何生成一个）

______________________________________________________________________

快速开始

步骤1：生成您的Domotz API密钥

1. 登录 多莫茨门户网站
2. 导航到 帐户设置 → API密钥
3. 点击 生成新密钥
4. 复制并安全保存密钥（您将无法再次看到它）

步骤2：下载MCP服务器文件

克隆或下载此存储库到您的本地计算机：

git clone https://github.com/jacedomotz/domotz-mcp-server.git
cd domotz-mcp-server

记住保存此文件夹的位置 -在步骤4中，您需要完整的路径。

步骤3：安装依赖项

npm install

步骤4：配置Claude桌面

找到您的Claude Desktop配置文件：

打开文件并添加Domotz MCP服务器配置。使用 claude_desktop_config.example.json 作为参考：

{
  "mcpServers": {
    "domotz": {
      "command": "node",
      "args": ["REPLACE_WITH_FULL_PATH_TO/domotz-mcp-server/index.js"],
      "env": {
        "DOMOTZ_API_KEY": "YOUR_API_KEY_HERE",
        "DOMOTZ_API_BASE_URL": "https://api-us-east-1-cell-1.domotz.com/public-api/v1"
      }
    }
  }
}

你必须定制三件事：

1. args 路径 -替换为完整路径 index.js 在您的机器上：

- Windows示例： ["C:\\Users\\YourName\\domotz-mcp-server\\index.js"] - Mac示例： ["/Users/yourname/domotz-mcp-server/index.js"] - Linux示例： ["/home/yourname/domotz-mcp-server/index.js"]

1. DOMOTZ_API_KEY -替换为步骤1中的实际API密钥

1. DOMOTZ_API_BASE_URL -使用与您的Domotz帐户区域匹配的URL：

- 我们： https://api-us-east-1-cell-1.domotz.com/public-api/v1 - 欧洲： https://api-eu-west-1-cell-1.domotz.com/public-api/v1

Windows用户： 使用双反睫毛(\\)在路径中，或正斜杠(/).

步骤5：重新启动克劳德桌面

退出并重新打开Claude Desktop以加载新的MCP服务器配置。

步骤6：验证连接

在克劳德，试着问：

“列出我的Domotz收藏家”

如果配置正确，Claude将查询Domotz API并返回收集器列表。

______________________________________________________________________

可用功能

此MCP服务器公开 10类工具 覆盖 133 Domotz API操作:

每个工具都使用 action 参数来选择要执行的API操作。例如， domotz_agents 和 action: "list" 列出所有收藏家，同时 action: "ip_conflicts" 检查IP冲突。

______________________________________________________________________

查询示例

以下是一些您可以尝试的实用查询：

网络概述

• “给我一份我所有Domotz收藏家及其状态的摘要”
• “我的所有网站上有多少设备受到监控？”

故障排除

• “显示收集器12345上的所有脱机设备”
• “过去一周设备67890的RTD（延迟）历史记录是什么？”
• “主办公室网络上是否存在任何IP冲突？”

报告

• “列出Acme Corp网站上所有设备的最后状态”
• “显示过去一个月的互联网速度测试历史记录”

配置

• “设备11111上配置了哪些SNMP传感器？”
• “列出我创建的所有自定义标记”

______________________________________________________________________

故障排除

“克劳德看不到Domotz工具”

1. 验证中的路径 claude_desktop_config.json 是正确的，并指向 index.js
2. 确保Node.js已安装并可从PATH访问
3. 检查API键设置是否正确（没有额外的空格或引号问题）
4. 完全重新启动Claude Desktop（而不仅仅是关闭窗口）

“API调用失败”

1. 验证您的API密钥在Domotz门户中是否有效
2. 检查您是否使用了正确的API地区URL（美国与欧洲）
3. 确保您对正在尝试的操作具有适当的权限

“速率限制错误”

Domotz API有费率限制。如果你连续快速地提出许多请求，你可能会达到这些限制。请稍等，然后重试。

______________________________________________________________________

安全说明

• 永远不要公开共享您的API密钥 -钥匙在 claude_desktop_config.json 仅供您使用
• API密钥具有完全帐户访问权限 -任何拥有您密钥的人都可以访问您的Domotz数据
• 此MCP服务器文件可以安全共享 -它只包含端点定义，不包含凭据
• 如果钥匙被盗，请旋转钥匙 -如果您怀疑存在暴露，请在Domotz门户中生成新密钥

______________________________________________________________________

文件结构

domotz-mcp-server/
├── index.js                            # MCP server entry point
├── package.json                        # Node.js dependencies
├── README.md                           # This file
├── LICENSE                             # MIT license
├── claude_desktop_config.example.json  # Claude Desktop config template
├── lib/
│   ├── api.js                          # Domotz API client (Axios)
│   └── registry.js                     # Generic action dispatcher
├── categories/
│   ├── agents.js                       # domotz_agents (31 actions)
│   ├── devices.js                      # domotz_devices (17 actions)
│   ├── monitoring.js                   # domotz_monitoring (13 actions)
│   ├── alerts.js                       # domotz_alerts (8 actions)
│   ├── network.js                      # domotz_network (14 actions)
│   ├── configuration.js               # domotz_configuration (8 actions)
│   ├── power.js                        # domotz_power (7 actions)
│   ├── drivers.js                      # domotz_drivers (8 actions)
│   ├── inventory.js                    # domotz_inventory (19 actions)
│   └── account.js                      # domotz_account (5 actions)
└── .claude/
    └── skills/
        └── domotz-api/                 # Claude Code skill (auto-loaded)
            ├── SKILL.md                # Main skill reference
            ├── references/
            │   └── tool-reference.md   # Full action catalog
            └── examples/
                └── common-queries.md   # Natural language → tool call examples

______________________________________________________________________

资源

• Domotz API文档
• 模型上下文协议（MCP）规范
• 克劳德桌面下载
• 多莫茨门户网站

______________________________________________________________________

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

______________________________________________________________________

关于

创建此MCP服务器是为了帮助MSP、IT团队和网络管理员利用AI进行网络监控和管理任务。通过将Claude连接到Domotz，您可以使用自然语言查询您的网络基础设施，而无需导航多个仪表板。

问题？ 联系Domotz社区https://www.reddit.com/r/domotz/.