设备管理服务器

一个用于Orb Cloud设备管理的MCP服务器,可将Orb Cloud组织和设备暴露给任何MCP兼容客户端。

  • by briandconnelly
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 briandconnelly/orb-cloud-mcp

使用说明

orb云mcp

一 主控程序 服务器 Orb云 设备管理。将您的Orb Cloud组织和设备暴露给任何兼容MCP的客户端(Claude Desktop、Cursor等)。

工具与资源

工具

工具 说明
list_organizations 列出使用API密钥可访问的所有组织
list_devices 列出组织中的设备——硬件信息、位置、固件和配置(缓存)
get_device_telemetry 组织中设备的实时连接状态和Orb性能评分
trigger_speedtest 触发a content 或 top 设备速度测试
configure_temp_datasets 启用从设备到自定义端点的临时数据推送

资源

URI 描述
orb://organizations 所有可访问的组织(缓存)
orb://organizations/{organization_id}/devices 组织的稳定设备信息(缓存)

list_devices 和 list_organizations 默认情况下,结果缓存5分钟(请参见 配置).

需求

  • Python 3.10+
  • OrbCloud API令牌-需要 Plus计划或以上.在Orb Cloud面板中生成令牌 设置→ API密钥.

安装

pip install orb-cloud-mcp

配置

环境变量 必填 默认 说明
ORB_CLOUD_API_KEY 是 - 您的Orb Cloud API令牌
ORB_CLOUD_CACHE_TTL 没有 300 以秒为单位缓存TTL以获得稳定的数据。设置为 0 禁用缓存。

克劳德桌面版

配置文件的位置因平台而异:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "orb-cloud": {
      "command": "uvx",
      "args": ["orb-cloud-mcp"],
      "env": {
        "ORB_CLOUD_API_KEY": "your-token-here"
      }
    }
  }
}

Cursor和其他MCP客户端

{
  "mcpServers": {
    "orb-cloud": {
      "command": "uvx",
      "args": ["orb-cloud-mcp"],
      "env": {
        "ORB_CLOUD_API_KEY": "your-token-here"
      }
    }
  }
}

免责声明

此工具与Orb没有正式关联。如需官方支持,请访问 orb.net.