switcher-mcp

liebstein/switcher-mcp

3.2

If you are the rightful owner of switcher-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Switcher MCP is a Model Context Protocol server designed for integrating Switcher KIS devices, enabling local network communication without the need for cloud services.

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 -
  1. 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