Bond MCP Server

Instructions

Implementation Reference

• src/bond_mcp/server.py:121-153 (handler)

  The @mcp.tool()-decorated async function that implements the toggle_device_power tool logic: retrieves current device state, toggles power by calling turn_on or turn_off on the BondClient, and returns the result or error.
  @mcp.tool() async def toggle_device_power(device_id: str) -> Dict[str, Any]: """Toggle power state of a Bond device (on/off). Args: device_id: The Bond device identifier Returns: Result of the toggle operation. """ try: async with await get_bond_client() as client: # Get current state to determine action current_state = await client.get_device_state(device_id) power = current_state.get("power", 0) if power == 1: result = await client.turn_off(device_id) action = "turned off" else: result = await client.turn_on(device_id) action = "turned on" return { "device_id": device_id, "action": action, "result": result } except BondAPIError as e: return {"error": f"Failed to toggle device power: {str(e)}"} except Exception as e: logger.error(f"Unexpected error toggling device power: {e}") return {"error": f"Unexpected error: {str(e)}"}
• src/bond_mcp/server.py:121-121 (registration)

  The @mcp.tool() decorator registers the toggle_device_power function as an MCP tool.
  @mcp.tool()