Acceleronix物联网MCP服务器
 ](https://nodejs.org/) 
用于管理Acceleronix IoT设备的模型上下文协议（MCP）服务器。该服务器与Claude Desktop和Cursor等人工智能助手无缝集成，通过自然语言命令控制和监控物联网设备。
🚀 准备使用：预构建的DXT包可在 dxt-release/ 文件夹\ 🔧 开发者友好：支持TypeScript的完整源代码\ 🌐 通用兼容性：可与任何兼容MCP的AI助手配合使用✨ 特性
- 📋 设备管理：列出支持分页的物联网产品和设备
- 🎛️ 设备控制：控制设备风扇开关，设置风扇速度模式，管理蜂鸣器
- 📊 数据监控：读取实时传感器数据（温度、湿度、压力）
- 📍 定位服务：查询设备位置和资源信息
- 📈 历史数据：通过完整的传感器数据解析访问设备数据历史和事件日志
- 🔧 事物模型支持：动态TSL（事物规范语言）集成，实现通用设备兼容性
- ✅ 经过全面测试：成功检索和解析设备传感器数据，包括温度、湿度和压力读数
📦 安装方法
此MCP服务器支持两种安装方法：
🚀 方法1:Claude桌面版DXT包（推荐）
最快的入门方法-无需构建过程！
- 下载DXT软件包
# Navigate to the dxt-release folder
cd dxt-release/
# The pre-built DXT file is ready to use
ls acceleronix-iot-mcp-server-v1.0.0.dxt- 在Claude桌面中安装
- 打开克劳德桌面 - 转到“设置”→ 扩展 - 点击“从DXT文件安装” - 选择 acceleronix-iot-mcp-server-v1.0.0.dxt - 配置API凭据（请参阅先决条件部分）
📁 包含什么：The dxt-release/ 该文件夹包含完整的DXT包，包括文档、编译代码和所有依赖项，无需额外设置！
🛠️ 方法2：本地MCP服务器安装
适用于高级用户或与其他MCP兼容工具集成，如 光标, 带来等等。
先决条件
- Node.js 18+
- npm或纱线
安装步骤
# Clone the repository
git clone
cd acc-mcp-server_local
# Install dependencies
npm install
# Build the project
npm run buildMCP服务器配置
适用于克劳德桌面 (claude_desktop_config.json):
{
"globalShortcut": "Ctrl+Space",
"mcpServers": {
"acceleronix-iot-mcp-server": {
"command": "node",
"args": ["/path/to/acc-mcp-server_local/dist/local-index.js"],
"env": {
"BASE_URL": "https://iot-api.acceleronix.io",
"ACCESS_KEY": "your_access_key",
"ACCESS_SECRET": "your_access_secret"
}
}
}
}对于光标 （MCP设置）：
{
"globalShortcut": "",
"mcpServers": {
"acceleronix-iot-mcp-server": {
"command": "node",
"args": ["/path/to/acc-mcp-server_local/dist/local-index.js"],
"env": {
"BASE_URL": "https://iot-api.acceleronix.io",
"ACCESS_KEY": "your_access_key",
"ACCESS_SECRET": "your_access_secret"
}
}
}
}🔑 先决条件
获取Acceleronix平台API凭据
在使用此MCP服务器之前，请从Acceleronix IoT平台获取API证书：
第一步：注册并访问开发者中心
- 注册：参观 Acceleronix开发平台 并创建一个帐户
- 访问开发者中心：登录您的开发人员仪表板
步骤2：创建SaaS应用程序
- 引导到 “SaaS开发” → “SaaS管理”
- 点击 “创建SaaS应用程序”
- 填写申请信息并保存
步骤3：配置API服务
- 首选 “SaaS开发” → “服务”
- 启用和授权所需的API服务包
- 重要：您只能在服务授权后调用API
步骤4：授权产品访问
- 引导到 “SaaS开发” → “产品”
- 授权应用程序可以访问的产品数据
- 重要：只能通过API查询授权的产品数据
步骤5：获取API凭据
- 在您的SaaS应用程序设置中，找到您的凭据
- 注意你的
ACCESS_KEY和ACCESS_SECRET - 这些凭据用于API身份验证
🔧 可用工具
| 工具 | 说明 | 参数 |
|---|---|---|
list_products_paginated | 按页码列出物联网产品 | cursor （可选） |
list_devices_paginated | 列出产品的设备 | product_key, cursor （可选） |
get_device_details | 获取详细的设备信息 | product_key, device_key |
fan_switch | 控制装置风扇（开/关） | product_key, device_key, on_off |
set_fan_mode | 设置风扇速度模式 | product_key, device_key, mode （低/中/高） |
buzzer_switch | 控制装置蜂鸣器 | product_key, device_key, on_off |
get_device_data_history | 查询历史设备数据（包括最新读数） | product_key, device_key，时间选项 |
query_device_location | 获取设备位置信息 | product_key, device_key |
health_check | 检查服务器连接 | 无 |
💡 使用示例
自然语言命令
- “打开我的物联网设备的风扇（设备密钥或设备名称）”
- “将风扇设置为中速”
- “我的设备（设备密钥或设备名称）的最新温度读数是多少？”
- “显示设备位置”
- “获取最近24小时的传感器数据”
- “列出我的所有物联网产品（产品名称或产品密钥）”
设备控制示例
风扇控制：
- “请为我的设备打开风扇（设备密钥或设备名称）”
- “将风扇切换到低速模式”
- “关掉风扇”
数据监控：
- “显示当前的温度和湿度读数”
- “获取最新的10个传感器数据点”
- “设备当前状态如何？”
设备管理：
- “列出我的产品中的所有设备（产品名称或产品密钥）”
- “显示有关我的设备的详细信息（设备密钥或设备名称）”
- “我的设备（设备密钥或设备名称）位于何处？”
📁 项目结构
acc-mcp-server_local/
├── src/ # Source code
│ ├── local-index.ts # Main entry point
│ ├── local-iot-server.ts # MCP server implementation
│ └── local-iot-utils.ts # API utilities
├── dist/ # Compiled JavaScript
├── dxt-release/ # DXT package for Claude Desktop
│ ├── README.md # DXT-specific documentation
│ ├── *.dxt # Pre-built DXT file
│ └── build.sh # DXT build script
├── package.json
└── README.md # This file🚧 发展
建设项目
npm run build创建DXT包
# Use the provided build script
./build.sh
# Or manually from dxt-release folder
cd dxt-release/
./build.sh🔍 故障排除
常见问题
| 问题 | 解决方案 |
|---|---|
| ❌ 认证错误 | 验证 ACCESS_KEY 和 ACCESS_SECRET 从您的SaaS应用程序来看是正确的 |
| 🔗 连接失败 | 检查 BASE_URL 可访问且格式正确 |
| 🔍 找不到设备 | 确保 product_key 和 device_key 存在于授权产品中 |
| 🎛️ 控制命令失败 | 通过Thing Model规范验证设备是否支持操作 |
| 📊 无数据访问 | 确保产品数据在SaaS应用程序设置中得到授权 |
💡 专业提示：使用 health_check 该工具可快速验证您的配置和连接状态。
🤝 贡献
我们欢迎社区的贡献！以下是如何帮助改进Acceleronix IoT MCP服务器：
- 🐛 Bug修复和改进
- 📖 文档增强
- 🔧 新的物联网设备集成
- 🧪 测试覆盖率提高
- 🌐 国际化支持
📄 许可证
根据许可文件中规定的条款进行许可。