Nature Remo MCP server

Nature Remo MCP server

site icon
2025.04.09 5
TypeScript家庭自动化远程控制其它
Nature Remo MCP server 是一个用于 Nature Remo API 的 MCP 服务器,旨在通过 Model Context Protocol SDK 处理请求并与 Nature Remo API 交互。它提供了管理和自动化与 Nature Remo 设备交互的工具。
View on GitHub

Overview

基本能力

产品定位

Nature Remo MCP server 是一个用于 Nature Remo API 的 MCP 服务器,旨在通过 Model Context Protocol SDK 处理请求并与 Nature Remo API 交互。

核心功能

  • 管理和自动化与 Nature Remo 设备的交互
  • 提供多种工具来操作设备

适用场景

  • 家庭自动化
  • 远程控制 Nature Remo 设备

工具列表

  • list_devices - 列出家庭中的设备。
  • 无需参数

  • list_appliances - 列出家庭中的电器。

  • 无需参数

  • operate_tv - 操作电视电器。

  • applianceId: 电器 ID (字符串, 必需)
  • button: 按钮标签 (字符串, 必需)

  • operate_aircon - 操作空调电器。

  • applianceId: 电器 ID (字符串, 必需)
  • airDirection: 风向 (字符串, 可选)
  • airDirectionH: 水平风向 (字符串, 可选)
  • airVolume: 风量 (字符串, 可选)
  • button: 按钮标签 (字符串, 可选)
  • operationMode: 操作模式 (字符串, 可选)
  • temperature: 温度 (字符串, 可选)
  • temperatureUnit: 温度单位 (字符串, 可选)

使用教程

使用依赖

  1. Nature Remo Home 上创建自己的 access_token。更多详情,请参阅 文档

安装教程

使用 VS Code

将以下配置添加到您的用户设置 (JSON) 文件中。通过按 Cmd + Shift + P 并选择 Preferences: Open User Settings (JSON) 来打开设置。

或者,您可以在工作区中创建一个 .vscode/mcp.json 文件以与他人共享配置。请注意,.vscode/mcp.json 文件中不需要 mcp 键。

{
  "mcp": {
    "servers": {
      "nature-remo": {
        "command": "npx",
        "args": [
          "-y",
          "noboru-i/nature-remo-mcp-server"
        ],
        "env": {
          "ACCESS_TOKEN": "<YOUR_TOKEN>"
        }
      }
    }
  }
}

使用 Claude Desktop

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "noboru-i/nature-remo-mcp-server"
      ],
      "env": {
        "ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

调试方式

安装完成后,可以通过运行提供的工具命令来测试服务器功能。例如,使用 list_deviceslist_appliances 工具来验证设备列表是否正确获取。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。