返回 MCP 目录
public公开dns本地运行

nature-remo-mcp-server

Nature Remo的MCP服务器,用于通过API与Nature Remo设备交互,提供设备管理和自动化操作功能。

article

README

🚀 Nature Remo MCP 服务器

Nature Remo 的 MCP 服务器可处理请求,并借助 Model Context Protocol SDK 与 Nature Remo API 进行交互。它提供了管理和自动化与 Nature Remo 设备交互的工具,让您更便捷地使用 Nature Remo 设备。

🚀 快速开始

Nature Remo 的 MCP 服务器,能有效处理请求,通过 Model Context Protocol SDK 与 Nature Remo API 进行交互。利用它提供的工具,可轻松管理和自动化与 Nature Remo 设备的交互。

✨ 主要特性

  • 借助 Model Context Protocol SDK 与 Nature Remo API 交互。
  • 提供多种工具,实现对 Nature Remo 设备交互的管理与自动化。

📦 安装指南

先决条件

需在 Nature Remo Home 创建自己的访问令牌。更多详细信息,请参阅 文档)。

设置

使用 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_devices - 列出家庭中的设备。
    • 无需参数
  • list_appliances - 列出家庭中的家电。
    • 无需参数
  • operate_tv - 操作 TV 家电。
    • applianceId:设备 ID(字符串,必填)
    • button:按钮标签(字符串,必填)
    • times:点击按钮的次数(整数,可选)
  • operate_aircon - 操作空调家电。
    • applianceId:设备 ID(字符串,必填)
    • airDirection:风向(字符串,可选)
    • airDirectionH:水平风向(字符串,可选)
    • airVolume:风量(字符串,可选)
    • button:按钮标签(字符串,可选)
    • operationMode:运行模式(字符串,可选)
    • temperature:温度(字符串,可选)
    • temperatureUnit:温度单位(字符串,可选)
    • times:点击按钮的次数(整数,可选)

📄 许可证

此项目根据 MIT 开源许可协议进行许可。完整的条款请参阅 MIT

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端