物联网设备管理服务器

Acceleronix物联网MCP服务器

用于管理Acceleronix IoT设备的模型上下文协议（MCP）服务器。该服务器与Claude Desktop和Cursor等人工智能助手无缝集成，通过自然语言命令控制和监控物联网设备。

🚀 准备使用：预构建的DXT包可在 dxt-release/ 文件夹
🔧 开发者友好：支持TypeScript的完整源代码
🌐 通用兼容性：可与任何兼容MCP的AI助手配合使用

✨ 特性

• 📋 设备管理：列出支持分页的物联网产品和设备
• 🎛️ 设备控制：控制设备风扇开关，设置风扇速度模式，管理蜂鸣器
• 📊 数据监控：读取实时传感器数据（温度、湿度、压力）
• 📍 定位服务：查询设备位置和资源信息
• 📈 历史数据：通过完整的传感器数据解析访问设备数据历史和事件日志
• 🔧 事物模型支持：动态TSL（事物规范语言）集成，实现通用设备兼容性
• ✅ 经过全面测试：成功检索和解析设备传感器数据，包括温度、湿度和压力读数

📦 安装方法

此MCP服务器支持两种安装方法：

🚀 方法1:Claude桌面版DXT包（推荐）

最快的入门方法-无需构建过程！

1. 下载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
   

2. 在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 <repository-url>
cd acc-mcp-server_local

# Install dependencies
npm install

# Build the project
npm run build

MCP服务器配置

适用于克劳德桌面 (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证书：

第一步：注册并访问开发者中心

1. 注册：参观 Acceleronix开发平台 并创建一个帐户
2. 访问开发者中心：登录您的开发人员仪表板

步骤2：创建SaaS应用程序

1. 引导到 “SaaS开发” → “SaaS管理”
2. 点击 “创建SaaS应用程序”
3. 填写申请信息并保存

步骤3：配置API服务

1. 首选 “SaaS开发” → “服务”
2. 启用和授权所需的API服务包
3. 重要：您只能在服务授权后调用API

步骤4：授权产品访问

1. 引导到 “SaaS开发” → “产品”
2. 授权应用程序可以访问的产品数据
3. 重要：只能通过API查询授权的产品数据

步骤5：获取API凭据

1. 在您的SaaS应用程序设置中，找到您的凭据
2. 注意你的 ACCESS_KEY 和 ACCESS_SECRET
3. 这些凭据用于API身份验证

🔧 可用工具

💡 使用示例

自然语言命令

• “打开我的物联网设备的风扇（设备密钥或设备名称）”
• “将风扇设置为中速”
• “我的设备（设备密钥或设备名称）的最新温度读数是多少？”
• “显示设备位置”
• “获取最近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

🔍 故障排除

常见问题

💡 专业提示：使用 health_check 该工具可快速验证您的配置和连接状态。

🤝 贡献

我们欢迎社区的贡献！以下是如何帮助改进Acceleronix IoT MCP服务器：

• 🐛 Bug修复和改进
• 📖 文档增强
• 🔧 新的物联网设备集成
• 🧪 测试覆盖率提高
• 🌐 国际化支持

📄 许可证

根据许可文件中规定的条款进行许可。