Smart Bulb MCP Server

Сервер Model Context Protocol (MCP), созданный на Node.js и TypeScript, для управления умными лампями через IP. О н поддерживает:

• Mock/ими тируемая ламба: для локального тестирования и разработки без физического оборудования.

• Yeelight/Xiaomi Bulb: испоьзует стандартный TCP-порt 55443 (локальный прогокол JSON-RPC) для управления реальными физическими умными лампа м и.

Возможности

• Подкл ючение по IP: динамически подключайтесь к разным ампам в вашей локальной сети.

• Управление питанием: включайте или выключайте лампу.

• Яркость и интенсивность: регулруйте яркость / интенсивность ламп от 1 % до 100 %.

• Управление ц ветом: задавайте цвета с помощью RGB-координат или шестнадцатеричных цветовых кодов.

• Запросы сос.=... Подреживает*: позитивное состояние ламп в рельном времени.

Related MCP server: Philips Hue MCP Service

Нача ло работы

1. Сборка се рвера

Сначала установите зависимост и компилируйте TypeScript-файлы:

# Install dependencies
npm install

# Compile the TypeScript files
npm run build

Собранные файлы будут помещены в катало г dist/.

2. Запуск / Разработка

Сервер можно запустить напрямую через стандартный ввод-вывод (Stdio):

# Run the built JS
npm start

# Compile and run in development mode
npm run dev

Настройка с MCP-климентами

Чтобы этот сервер использовался с MCP-клиентом (например, Claude Desktop или Cursor), добавьте конфигурацию сервера в ваш фал конфигурации.

Для Claude Desktop

Отредактируйте ваш claude_desktop_config.json (обычно он расоложен в %APPDATA%\Claude на Windows или ~/Library/Application Support/Claude на macOS):

{
  "mcpServers": {
    "smart-bulb": {
      "command": "node",
      "args": ["D:/Palwinder/mcp-server-bulb/dist/index.js"]
    }
  }
}

Примечание: Примечание: Замените D/:/Palwindder/mcp-server-bulb/dist/index.js на абслютный путь к dist/index.js на вашем компьютере.

Доступные MCP-инструменты

После подключения сервера LLM хоста получит доступ к следующим инстру ментам:

1. onnect_bulb

Подключается к лампе по указанному IP-адресу.

• Аргументы:

  • ip (string, required): IP-адрес (например, "192.168.1.15" или "127.0.0.1").

  • type (enum ["mock", "yealight"], по умолчанию: "mock"): Тип драйр. Используйте "mock" для проверки возожностей сервера без физиЦеского оборудования, а "yealight" — для реальных ламп Yealight.

  • port (number, optional): Порт для использования. По умолчанию 55443 для Yeelight и 9999 для Mock.

2. disconnect_bulb

Отклю чат от теkущей подкюченй лампы.

• Аргументы: нет.

3. mbp_bulb_state

Получает статус подклчения, состоянием питателя, прцент яркости и интенсивности и RGB-цвет.

• Аргументы: нет.

4. mrc_p_bicago

Включает или выключает лампу.

• Аргументы:

  • power (boolean, required): true для включения, false для выключения.

5. set_bul_brightness

Устанавливает яркость / интensiveness лампы.

• Аргументы:

  • brightness (number, required): значени я от 1 до 100.

6. set_bul_color_rg

Устанавливает цвет лампы с помощью RGB-знв.

• Аргументы:

  • r (number, required): Красный компнент 0 –255.

  • g (number, required): Зелёный компнент 0 –255.

  • b (number, required): Сhinй компнент 0 –255.

7. set_bul_color_hx

Устанавливает цвет лампы с помощью ашесtнадцатеричного кода цвета.

• Аргументы:

  • hex (string, required): Шtнадцатиричный код (например, "#FF0000" или "00FF00").

Клиент OpenAI

Мы посролии клиент-обёртку в src/openai-client.ts, котрая позволяет передвать промпрты напрямую в OpenAI. OpenAI затем автономно вызывает инструменты MCP для выполнения действий на вашей умной лампе.

Настройка и запуск клиента

1. Укажите ваш OpenAI API-ключ: В Windows (PowerShell):

   $env:OPENAI_API_KEY="your-actual-api-key"

   На macOS/Linux (Bash):

   export OPENAI_API_KEY="your-actual-api-key"

2. Запустите клиент:

   • Интерактивный режكم CLI:

     npm run client

     Откроется подчодная обоwi. Попробуйте ввести:

     Подкл ючитесь к mock-лампе, включите её, установите яркость 80% и цвет жлтый.

   • Режим разовой команди: Передайте ваш промпт напрям ую как аргументы:

     npm run client -- "connect to the mock bulb, turn it on, and set color to blue"

3. Настройка модели (не обязателно): По умолчанию используется gpt-4o-mini. Вы можете изменить модель, устанновив перенну «openApp`:

   $env:OPENAI_MODEL="gpt-4o"

Детали для разрабочика и архитектура

Проект об ладает модульной архитектой:

• src/bulb/interface.ts: о