Iot Cloud MCP

MCP运维云端

提供方 dadadadas111 · 包名 tsc

运维云端 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

MCP网关服务器,连接AI助手与Rogo物联网云平台,实现AI客户端查询和控制物联网设备的功能。

一句话选型结论

按资料字段整理

Iot Cloud MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 15 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量15暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

物联网TypeScript本地部署AI集成设备控制多租户RESTAPI

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx tsc --noEmit # Type check

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 15 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 15 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Iot Cloud MCP当前 15 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方dadadadas111上游标注的维护方 dadadadas111
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时tsc · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.9 KB
来自项目仓库与上游目录的原文,未做删改

物联网云mcp

MCP(模型上下文协议)网关服务器,将AI助手连接到Rogo IoT Cloud平台。使用NestJS构建,它将MCP工具调用转换为结构化REST API请求,使ChatGPT和Claude等人工智能客户端能够查询和控制物联网设备。

建筑```

MCP Client (ChatGPT / Claude / n8n)
│
▼
┌──────────────────────────────────────────────┐
│ POST /mcp/:projectApiKey │
│ ┌─ JWT auth ─ Session mgmt ─ JSON-RPC ─┐ │
│ │ McpController → ProtocolHandler │ │
│ │ → ToolExecutor → IotApiService │ │
│ └───────────────────────────────────────┘ │
│ Redis (sessions) Local cache (servers) │
└──────────────────────────────────────────────┘
│
▼
Rogo IoT Cloud REST API


**多用户** -每个项目都使用嵌入在URL中的API密钥。会话的范围为每个项目、每个用户。

## MCP工具

|工具|说明|
| -------------------------- | ----------------------------------- |
| `fetch_user` |获取当前用户配置文件|
| `search` |跨设备、位置搜索|
| `list_devices` |列出项目中的所有设备|
| `list_locations` |列出所有地点|
| `list_groups` |列出设备组|
| `get_device` |获取单个设备的详细信息+状态|
| `update_device` |更新设备属性|
| `delete_device` |删除设备|
| `get_device_state` |通过ID获取设备状态|
| `get_device_state_by_mac` |通过MAC地址获取设备状态|
| `get_location_state` |获取某个位置的所有设备状态|
| `control_device` |发送控制命令(完整)|
| `control_device_simple` |发送控制命令(简化)|
| `get_device_documentation` |获取设备文档|
| `fetch` |通用数据提取|

## 入门指南

### 先决条件

- Node.js 18+
- Redis 6+
- 访问Rogo物联网云项目API密钥

### 安装```bash
git clone https://github.com/dadadadas111/iot-cloud-mcp.git
cd iot-cloud-mcp
npm install

配置

复制示例环境文件并填写您的值:```bash
cp .env.example .env


关键变量:

|变量|必填|默认|描述|
| ------------------ | ---------- | ----------------------- | ------------------------------------------ |
| `IOT_API_BASE_URL` |是|-| Rogo物联网云API基础URL|
| `BASE_URL` |是(prod)| `http://localhost:3001` |此服务器的公共URL(OAuth发现)|
| `REDIS_HOST` |是的| `localhost` |Redis主机名|
| `PORT` |没有| `3001` |服务器端口|
| `MCP_SESSION_TTL` |没有| `3600` |会话TTL(秒)|

看 `.env.example` 查看带有描述的完整列表。

### 跑步```bash
# Development (hot reload)
npm run start:dev

# Production build
npm run build
npm run start:prod

码头工人```bash

Production

docker compose up -d

Staging

docker compose -f docker-compose.staging.yml up -d


## 认证

服务器为MCP客户端身份验证实现了OAuth 2.1:

1. 客户端通过以下方式发现身份验证端点 `/.well-known/oauth-authorization-server`
1. 用户通过以下方式进行身份验证 `/authorize` 流(代理到Rogo IoT Cloud)
1. 客户端在以下地址交换JWT令牌的授权码 `/token`
1. 不记名代币包含在所有后续代币中 `/mcp/:projectApiKey` 请求:

## 项目结构```
src/
├── main.ts                 # Bootstrap
├── app.module.ts           # Root module
├── mcp/                    # MCP protocol — controller, sessions, server factory
├── tools/                  # 15 MCP tool definitions + executor
│   ├── definitions/        # Individual tool files
│   └── services/           # Registry + executor
├── resources/              # MCP resource definitions
├── auth/                   # OAuth 2.1 flow
├── discovery/              # .well-known endpoints
├── proxy/                  # IoT API proxy layer (IotApiService)
├── redis/                  # Redis client module (global)
└── common/                 # Shared utils, constants, decorators

发展```bash

npm test # Run tests
npx tsc --noEmit # Type check
npm run lint # Lint
npm run format # Format with Prettier
```

部署

通过GitHub操作进行CI/CD:

  • 推至 main → 构建Docker镜像→ 部署到生产环境
  • PR到 main → 构建Docker镜像→ 部署到预发布环境

看 docs/DEPLOYMENT.md 获取完整的操作手册。

技术栈

  • 运行时:NestJS 10+TypeScript
  • MCP-SDK: @modelcontextprotocol/sdk (流式HTTP传输)
  • 会话存储:Redis(ioredis)
  • 验证:Zod v4
  • 认证:OAuth 2.1+JWT
  • 测试:杰斯特
  • 部署:Docker+GitHub操作

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Iot Cloud MCP 怎么安装?

在客户端按下面的安装命令接入:npx tsc --noEmit # Type check。对应的包名是 tsc。装完在客户端配置里引用同一个包或端点。

Iot Cloud MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Iot Cloud MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Iot Cloud MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Iot Cloud MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Iot Cloud MCP 能提供哪些能力?

资料显示约 15 个工具;能力标签包括 物联网、多租户、TypeScript、Claude、设备控制。具体工具清单以官方文档为准。

Iot Cloud MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Iot Cloud MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。