Nature Remo MCP Server

🚀 Nature Remo MCP Server

The MCP server for Nature Remo, which is used to handle requests and interact with the Nature Remo API using the Model Context Protocol SDK. It provides tools for managing and automating interactions with Nature Remo devices.

🚀 Quick Start

This is an MCP server designed for Nature Remo, aiming to handle requests and interact with the Nature Remo API using the Model Context Protocol SDK. It offers tools to manage and automate interactions with Nature Remo devices.

✨ Features

This server provides the following tools:

• list_devices - List the devices in the home.

  • No parameters required

• list_appliances - List the appliances in the home.

  • No parameters required

• operate_tv - Operate TV appliances.

  • applianceId: Device ID (string, required)
  • button: Button label (string, required)
  • times: Number of button clicks (integer, optional)

• operate_aircon - Operate air - conditioning appliances.

  • applianceId: Device ID (string, required)
  • airDirection: Air direction (string, optional)
  • airDirectionH: Horizontal air direction (string, optional)
  • airVolume: Air volume (string, optional)
  • button: Button label (string, optional)
  • operationMode: Operating mode (string, optional)
  • temperature: Temperature (string, optional)
  • temperatureUnit: Temperature unit (string, optional)
  • times: Number of button clicks (integer, optional)

📦 Installation

Prerequisites

1. Create your own access token at Nature Remo Home. For more details, refer to the documentation.

Setup

Using VS Code

Add the following configuration to your user settings (JSON) file. Open the settings by pressing Cmd + Shift + P and selecting Preferences: Open User Settings (JSON).

Alternatively, you can create a .vscode/mcp.json file in your workspace to share the configuration with other users.

⚠️ Important Note

The mcp key is not required in the .vscode/mcp.json file.

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

Using Claude Desktop

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

📄 License

This project is licensed under the MIT open - source license. See MIT for the full terms.