Nature Remo MCP 服务器使用说明

项目简介

Nature Remo MCP 服务器是一个实现了 Model Context Protocol 协议的服务器端应用，它作为 LLM 客户端（如 Claude Desktop）与 Nature Remo 智能家居设备之间的桥梁。通过此服务器，LLM 客户端可以列出您的 Nature Remo 设备和智能家居电器，并调用工具来控制这些设备，例如控制电视和空调。

主要功能点

列出设备 (list_devices): 允许 LLM 获取您 Nature Remo 账户下注册的所有设备列表。
列出电器 (list_appliances): 允许 LLM 获取您 Nature Remo 账户下注册的所有智能家居电器列表。
操作电视 (operate_tv): 允许 LLM 控制指定的电视电器，例如切换频道、调整音量等（具体功能取决于 Nature Remo 和电视支持）。
操作空调 (operate_aircon): 允许 LLM 控制指定的空调电器，例如设置温度、模式、风向等（具体功能取决于 Nature Remo 和空调支持）。

安装步骤

本仓库本身不提供安装步骤，因为它作为一个 MCP 服务器，通常以独立进程或服务运行。您可以使用 'npx' 命令直接运行此服务器，无需额外安装步骤。

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以下是针对 Claude Desktop 的 'claude_desktop_config.json' 示例配置：

{
  "mcpServers": {
    "nature-remo": {  // 服务器名称，可以自定义，例如 "nature-remo"
      "command": "npx",  // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": [
        "-y",
        "noboru-i/nature-remo-mcp-server" //  GitHub 仓库地址，npx 会直接从 GitHub 下载并运行
      ],
      "env": {
        "ACCESS_TOKEN": "<YOUR_TOKEN>" // Nature Remo API 访问令牌，请替换为您的真实令牌
      }
    }
  }
}

配置参数说明:

'"nature-remo"': 您为这个 Nature Remo MCP 服务器自定义的名称。在 Claude Desktop 中，您将使用此名称来引用这个服务器。
'"command": "npx"': 指定用于启动服务器的命令是 'npx'，它允许您直接运行 npm 包，无需全局安装。
'"args": ["-y", "noboru-i/nature-remo-mcp-server"]': 'npx' 命令的参数。
- '"-y"': 自动确认执行 'npx' 可能需要的安装步骤。
- '"noboru-i/nature-remo-mcp-server"': 指定要运行的 npm 包是 GitHub 仓库 'noboru-i/nature-remo-mcp-server'。 'npx' 会自动从 GitHub 下载并运行该仓库的入口文件（通常是 'index.js' 或 'index.ts' 编译后的 'index.js'）。
'"env": { "ACCESS_TOKEN": "<YOUR_TOKEN>" }': 设置环境变量。
- '"ACCESS_TOKEN": "<YOUR_TOKEN>"': 非常重要。您需要将 '<YOUR_TOKEN>' 替换为您从 Nature Remo 开发者平台获取的 Nature Remo API 访问令牌。此令牌用于服务器验证您的 Nature Remo 账户，从而控制您的设备。

获取 Nature Remo API 访问令牌:

访问 Nature Remo Web App 并登录您的账户。
导航到 "设置" 或 "API" (具体位置可能因 Nature Remo Web App 更新而有所不同，请参考 Nature Remo 官方文档)。
创建一个新的 API 访问令牌并复制它。
将复制的访问令牌替换到 'claude_desktop_config.json' 文件中的 '<YOUR_TOKEN>' 位置。

基本使用方法

配置完成后，当您在支持 MCP 协议的 LLM 客户端（如 Claude Desktop）中使用时，客户端将能够连接到 Nature Remo MCP 服务器。您可以通过自然语言指令指示 LLM 使用以下工具来控制您的智能家居设备：

列出设备: 例如，您可以询问 "列出我的 Nature Remo 设备" 或 "我的设备有哪些？"。LLM 可能会调用 'list_devices' 工具并将设备列表返回给您。
列出电器: 例如，您可以询问 "列出我的电器" 或 "家里有哪些电器？"。LLM 可能会调用 'list_appliances' 工具并将电器列表返回给您。
控制电视: 例如，您可以说 "打开电视"、"将电视调到 XX 频道" 或 "关闭电视"。LLM 可能会调用 'operate_tv' 工具，并根据您的指令传递相应的参数（如电器 ID 和按钮名称）。
控制空调: 例如，您可以说 "打开空调"、"将空调温度设置为 26 度" 或 "调整空调风向"。LLM 可能会调用 'operate_aircon' 工具，并根据您的指令传递相应的参数（如电器 ID、温度、模式等）。

请注意: 具体可用的指令和功能取决于 LLM 客户端的理解能力以及 Nature Remo API 和您设备的实际支持情况。您可能需要参考 Nature Remo API 文档和 LLM 客户端的使用说明以获得更详细的指导。

关键词