Switcher MCP

Model Context Protocol (MCP) server for Switcher KIS device integration.

Setup

1. Install Poetry (if not already installed):

curl -sSL https://install.python-poetry.org | python3 -

2. Install dependencies:

poetry install

Usage

Run the MCP server:

poetry run switcher-mcp

Or activate the virtual environment and run directly:

poetry shell
python -m switcher_mcp.server

Available Tools

• discover_devices: Discover Switcher devices on the network
• get_device_state: Get the current state of a Switcher device
• turn_on: Turn on a Switcher device (with optional timer)
• turn_off: Turn off a Switcher device
• get_device_info: Get detailed device information

Device Discovery

First, run device discovery to find your Switcher devices:

# This will scan the network for ~5 seconds and return discovered devices
# Note the device_id, ip_address, and device_key for subsequent operations

Device Control

To control devices, you'll need:

• device_id: Unique identifier from discovery
• ip_address: Device IP address from discovery
• device_key: Authentication key from discovery

Configuration

The server uses the aioswitcher Python library to communicate with Switcher devices locally. No cloud connection required.

Development

• poetry run black .: Format code
• poetry run ruff check .: Lint code
• poetry run mypy .: Type checking
• poetry run pytest: Run tests

Dependencies

• Python 3.13+
• aioswitcher: Native Switcher device communication
• mcp: Model Context Protocol SDK