Neat Pulse MCP服务器
一 主控程序 服务器 洁净脉冲API，使Claude Code（或任何MCP客户端）能够管理您的Neat设备、房间、位置、地区和用户。
快速开始
1.获取您的凭证
你需要两样东西 整齐的脉搏:
- API密钥 --你的Bearer代币
- 组织ID --您的组织标识符
2.添加到克劳德代码
claude mcp add neat-pulse \
-e NEAT_PULSE_API_KEY=your-api-key \
-e NEAT_PULSE_ORG_ID=your-org-id \
-- npx neat-pulse-mcp就是这样。重新启动Claude Code并开始询问有关Neat设备的问题。
替代方案：手动配置
添加到您的Claude Code设置文件中：
{
"mcpServers": {
"neat-pulse": {
"type": "stdio",
"command": "npx",
"args": ["neat-pulse-mcp"],
"env": {
"NEAT_PULSE_API_KEY": "your-api-key",
"NEAT_PULSE_ORG_ID": "your-org-id"
}
}
}
}你能做什么
安装后，只需用自然语言询问Claude：
- “列出我的所有整洁设备”
- “哪些设备当前在线？”
- “会议室的温度是多少？”
- “重新启动大厅的酒吧”
- “创建一个名为演示室的新房间”
- “在设备X上将亮度设置为80%”
- “显示奥斯陆所有房间的传感器数据”
- “我组织的管理员是谁？”
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
NEAT_PULSE_API_KEY | 是 | Neat Pulse API的Bearer令牌 |
NEAT_PULSE_ORG_ID | 是 | 组织ID（自动插入所有API调用） |
工具（共29个）
端点（设备）
| 工具 | 说明 |
|---|---|
endpoints_list | 列出所有设备，可选择按以下方式筛选 regionId 或 locationId |
endpoints_get | 获取设备的详细状态和信息 |
endpoints_delete | 解开设备 |
endpoints_reboot | 重新启动设备和任何已配对的设备 |
endpoints_get_config | 获取设备的当前设置 |
endpoints_apply_config | 将配置更改应用于设备 |
endpoints_sensor_data | 获取最新的传感器读数（温度、湿度、二氧化碳、挥发性有机化合物、人数） |
endpoints_bulk_sensor_data | 获取所有设备的传感器数据 |
位置
| 工具 | 说明 |
|---|---|
locations_list | 列出所有地点及其区域分配 |
locations_create | 创建新位置，可选择分配给区域 |
locations_update | 更新位置的名称或地区 |
locations_delete | 删除位置 |
区域
| 工具 | 说明 |
|---|---|
regions_list | 列出所有地区及其位置 |
regions_create | 创建新区域 |
regions_update | 重命名区域 |
regions_delete | 删除区域 |
房间
| 工具 | 说明 |
|---|---|
rooms_list | 列出所有房间 |
rooms_get | 获取房间详细信息，包括已注册的设备 |
rooms_create | 创建房间，可选择指定位置 |
rooms_update | 更新房间的名称或位置 |
rooms_delete | 删除房间 |
rooms_sensor_data | 获取房间的聚合传感器数据 |
rooms_bulk_sensor_data | 获取所有房间的传感器数据 |
rooms_regenerate_dec | 重新生成房间的设备注册码（DEC） |
用户
| 工具 | 说明 |
|---|---|
users_list | 列出所有具有角色和身份验证方法的用户 |
users_get | 获取用户的详细信息 |
users_create | 创建用户并发送电子邮件邀请 |
users_update | 更新用户的角色 |
users_delete | 删除用户 |
设备配置
这 endpoints_apply_config 该工具接受以下设置的任意组合：
| 设置 | 类型 | 描述 |
|---|---|---|
brightness | number | 屏幕亮度（0.0-1.0） |
language | string | 设备语言 |
timezone | string | 例如。 Europe/Oslo |
time24h | boolean | 24小时时间格式 |
temperatureUnit | enum | TEMPERATURE_UNIT_CELSIUS / TEMPERATURE_UNIT_FAHRENHEIT |
defaultFramingMode | enum | DISABLED / GROUP / INDIVIDUAL / SPEAKER |
screenStandby | number | 屏幕待机超时（秒） |
screenStayOn | boolean | 保持屏幕始终打开 |
bluetooth | boolean | 启用蓝牙 |
autoWakeup | boolean | 启用自动唤醒 |
automaticUpdates | boolean | 启用自动更新 |
deepNoiseSuppression | boolean | 启用深度噪声抑制 |
nightMode | boolean | 启用夜间模式 |
usbMode | enum | PERIPHERAL / AUTO / MANUAL |
hdmiCecControl | boolean | 启用HDMI CEC控制 |
hdmiScreenMirroring | boolean | 启用HDMI屏幕镜像 |
allowNeatShare | boolean | 启用整洁共享 |
byodMode | boolean | 启用BYOD模式 |
shareAnalytics | boolean | 与Neat共享分析 |
看 整洁脉冲API文档 查看完整列表。
发展
git clone https://github.com/tristan-gfr/neat-pulse-mcp.git
cd neat-pulse-mcp
npm install
npm run build许可证
麻省理工学院