Neat Pulse MCP Server

Neat Pulse MCP服务器

一个定制的模型上下文协议（MCP）服务器，包装整个Neat Pulse REST API。这使Claude Code（或任何MCP客户端）能够管理您的整洁视频会议设备、读取传感器数据和控制您的Pulse组织。

它的作用

此服务器公开 37工具 9个类别：

设备（端点）

传感器数据

房间

位置

区域

用户

档案

审计日志

错误报告

房间注意事项

先决条件

1. A Neat Pulse账户 付费计划 （Plus或Pro）。API在Starter上不可用。
2. 在Pulse下生成的API密钥 设置>API密钥
3. 您的组织ID来自Pulse 设置 页
4. 已安装Node.js 18+

设置

______________________________________________________________________

苹果电脑

1.克隆存储库

打开终端并运行：

git clone https://github.com/Neat-Community-API/Neat-Pulse-MCP-Server.git ~/Documents/neat-pulse-mcp
cd ~/Documents/neat-pulse-mcp

2.安装Node.js（如果尚未安装）

从下载并安装 （版本18或更高版本）。

验证安装：

node --version

3.安装依赖项

npm install

4.建设项目

npm run build

5.添加到克劳德代码

首先，通过在项目目录中运行以下命令来获取项目文件夹的完整路径：

pwd

这将打印类似的内容 /Users/yourname/Documents/neat-pulse-mcp。复制该输出并在下面的命令中使用它：

claude mcp add neat-pulse \
  -e NEAT_PULSE_API_KEY=YOUR_API_KEY \
  -e NEAT_PULSE_ORG_ID=YOUR_ORG_ID \
  -- node /paste/your/path/here/build/index.js

替换 YOUR_API_KEY 和 YOUR_ORG_ID 使用您从Pulse获得的真实凭证 设置>API密钥 和 设置>组织.

例子： 如果 pwd 印刷的 /Users/jane/Documents/neat-pulse-mcp，命令的结尾应该是： -- node /Users/jane/Documents/neat-pulse-mcp/build/index.js

6.验证

claude
/mcp

你应该看看 neat-pulse 用绿色复选标记列出。

______________________________________________________________________

视窗

1.克隆存储库

打开PowerShell并运行：

git clone https://github.com/Neat-Community-API/Neat-Pulse-MCP-Server.git "$env:USERPROFILE\Documents\neat-pulse-mcp"
cd "$env:USERPROFILE\Documents\neat-pulse-mcp"

2.安装Node.js（如果尚未安装）

从下载并安装 （版本18或更高版本）。

验证安装：

node --version

3.安装依赖项

npm install

4.建设项目

npm run build

5.添加到克劳德代码

首先，通过在项目目录中运行以下命令来获取项目文件夹的完整路径：

cd

这将打印类似的内容 C:\Users\yourname。您的完整项目路径是输出加 \Documents\neat-pulse-mcp。在下面的命令中使用它：

claude mcp add neat-pulse -e NEAT_PULSE_API_KEY=YOUR_API_KEY -e NEAT_PULSE_ORG_ID=YOUR_ORG_ID -- node "C:\paste\your\path\here\build\index.js"

替换 YOUR_API_KEY 和 YOUR_ORG_ID 使用您从Pulse获得的真实凭证 设置>API密钥 和 设置>组织.

例子： 如果您的用户名是 jane，命令的结尾应该是： -- node "C:\Users\jane\Documents\neat-pulse-mcp\build\index.js"

6.验证

claude
/mcp

你应该看看 neat-pulse 用绿色复选标记列出。

______________________________________________________________________

用法示例

连接后，您可以问Claude以下问题：

设备管理：

• “列出我的所有整洁设备”
• “显示脱机设备”
• “设备X上的固件版本是什么？”
• “重新启动A会议室整洁的酒吧”

传感器数据：

• “我们所有房间的温度是多少？”
• “显示整个办公室的二氧化碳水平”
• “现在会议室里有多少人？”
• “获取达拉斯位置所有设备的湿度读数”

组织管理：

• “在休斯顿的地点创建一个名为‘行政会议室’的新房间”
• “列出所有地点及其所在地区”
• “哪些用户可以访问Pulse？”

项目结构

neat-pulse-mcp/
  src/
    client.ts    # Neat Pulse API HTTP client wrapper
    index.ts     # MCP server with all 37 tools registered
  build/         # Compiled JavaScript (after npm run build)
  package.json
  tsconfig.json
  README.md

API 参考

此服务器包装了官方的Neat Pulse API v0.1.1，文档位于： https://api.pulse.neat.no/docs/

所有请求都通过 https://api.pulse.neat.no/v1/orgs/{orgId}/... 使用承载令牌身份验证。

传感器数据可用

整洁的设备报告以下传感器数据（因设备型号而异）：

• 温度 （精度在+15°C至+40°C范围内为±1°C）
• 湿度 （精度在20%至80%范围内为±3.5%rH）
• 二氧化碳 层级
• 挥发性有机化合物 （挥发性有机化合物）
• 人数统计 （占用率）
• 快门关闭 （仅限整洁的框架，隐私快门是否遮挡相机）

故障排除

服务器在中显示为“失败” /mcp:

• 验证您的API密钥和组织ID是否正确
• 确保你构建了这个项目(npm run build)
• 检查路径 claude mcp add 命令指向正确的 build/index.js

API返回403：

• 您的API密钥可能没有正确的作用域。转到Pulse Settings（脉冲设置）>API密钥，并确保它同时具有读取和写入权限。

API返回404:

• 在脉冲设置中仔细检查您的组织ID

致谢

这个项目的灵感来自 纯脉冲mcp 由tristan gfr撰写。

许可证

麻省理工学院