ioBroker MCP服务器

ioBroker Simple-API MCP服务器

该项目提供了 模型上下文协议（MCP） 连接到您的服务器 ioBroker 的 实例通过 简单api适配器。它使MCP兼容客户端（如Claude Desktop、Cursor、VSCode等）能够使用标准化工具与您的ioBroker安装进行交互。

特性

• 将ioBroker简单api端点作为MCP工具公开
• 支持通过查询参数、基本身份验证或承载令牌进行身份验证
• 通过CLI参数或环境变量轻松配置
• 设计用于MCP客户端（stdio传输）

安装

您可以直接使用以下命令运行此服务器 npx （无需安装）或克隆并在本地运行。

与MCP客户端一起使用

将以下内容添加到MCP客户端配置中（例如，Claude Desktop、Cursor、VSCode等）：

"servers": {
  "iobroker-simple-api-mcp-server": {
    "type": "stdio",
    "command": "npx",
    "args": [
      "iobroker-simple-api-mcp-server",
      "--host=http://localhost:8087",
      "--authType=query",
      "--user=admin",
      "--pass=secret"
    ]
  }
}

您还可以通过环境变量提供身份验证和主机信息：

IOB_AUTH_TYPE=query IOB_USER=admin IOB_PASS=secret IOB_HOST=http://localhost:8087 

身份验证选项

• 查询参数：
  --authType=query --user=admin --pass=secret
• 基本身份验证：
  --authType=basic --user=admin --pass=secret
• 承载令牌：
  --authType=bearer --token=YOUR_TOKEN

所有选项都可以通过CLI参数或环境变量进行设置(IOB_AUTH_TYPE, IOB_USER, IOB_PASS, IOB_TOKEN, IOB_HOST).

支持的工具

• getPlainValue(stateID) –获取状态的明文值
• getState(stateID) –获取状态的值和信息
• setState(stateID, value) –设置状态的值
• toggleState(stateID) –切换布尔状态
• …以及更多（参见 ioBroker.simple-api文档)

许可证

麻省理工学院

鸣谢

• ioBroker.simple-api
• 模型上下文协议