uecs-ccm-mcp

MCP server for UECS-CCM greenhouse monitoring and control.

Directly participates in UECS (Ubiquitous Environment Control System) CCM multicast network to read sensor data and send actuator commands — no MQTT broker required.

What is UECS-CCM?

UECS is the Japanese standard protocol for greenhouse environment control, using UDP multicast (224.0.0.1:16520) with XML payloads. CCM (Communication Control Module) packets carry sensor readings (temperature, humidity, CO2, etc.) and actuator commands (irrigation, ventilation, curtain, etc.).

Related MCP server: HueMCP

Features

• 5 MCP tools for LLM-driven greenhouse control

• Zero-config networking: joins UDP multicast automatically

• Safety guardrails: actuator allowlist, rate limiting, max irrigation duration

• No MQTT dependency: talks CCM directly

• Standalone test scripts: scp to RPi and run with zero dependencies

Quick Start

Install

pip install uecs-ccm-mcp

Run as MCP Server

uecs-ccm-mcp

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "greenhouse": {
      "command": "uecs-ccm-mcp"
    }
  }
}

MCP Tools

Field Test Scripts

Standalone scripts (Python standard library only) for testing on RPi:

# Receive CCM packets
python3 scripts/ccm_receive_test.py
python3 scripts/ccm_receive_test.py --filter InAirTemp

# Send control packets (confirm before sending)
python3 scripts/ccm_send_test.py Irri 1      # Irrigation ON
python3 scripts/ccm_send_test.py Irri 0      # Irrigation OFF
python3 scripts/ccm_send_test.py VenRfWin 50 # Roof window 50%

Supported Hardware

Tested with:

• ArSprout greenhouse controller (sensor/actuator nodes)

• Raspberry Pi as CCM participant

• Any UECS-compliant node

Safety

• Only allowlisted actuator types can be controlled

• Minimum 1 second between commands (rate limiting)

• Maximum 3600 second irrigation duration

• Auto-OFF timer support

License

MIT