pixoo-mcp-server — MCP-сервер для Claude Code: как установить
Подключает светодиодные дисплеи Divoom Pixoo к ИИ-агенту. Выводит на матрицу пиксельную графику, графики, текст и HTML-страницы через локальную сеть.
claude mcp add --env PIXOO_IP=<PIXOO_IP> --env PIXOO_SIZE=<PIXOO_SIZE> --env PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> --env PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> --env PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> --transport stdio pixoo-mcp-server -- npx -y @cyanheads/pixoo-mcp-serverЧто делает pixoo-mcp-server
Сервер связывает ассистента с экранами Pixoo-64, Pixoo-16 и Pixoo-32. В наборе восемь инструментов и четыре ресурса. Агент может искать устройства в домашней сети через поиск Divoom, менять яркость или экранные циферблаты, а также запрашивать статус устройства.
Для вывода данных доступно несколько путей. Инструмент pixoo_display_text поддерживает три шрифта с автоподбором размера под ширину экрана. Для сложных макетов есть pixoo_compose_scene, собирающий композицию максимум из 50 слоёв с фигурами, графиками, иконками и спрайтами. Если нужна веб-верстка, pixoo_render_html отрисовывает HTML, SVG и Canvas через браузер без графического интерфейса.
Без прямого доступа к IP-адресу экрана в локальной сети передача кадров завершится ошибкой.
Какие задачи решает
- транслировать показатели и графики на экран Pixoo
- выводить текст с автоматическим масштабированием и прокруткой
- рендерить HTML, SVG и Canvas для светодиодного дисплея
- управлять яркостью, каналами и экранами устройства
Примеры запросов агенту
- Покажи текущий статус сборки проекта на экране Pixoo в теме neon
- Выведи на дисплей крупные часы шрифтом numerals с яркостью 50
- Отрисуй на панели Pixoo график с помощью
pixoo_compose_scene
Как установить pixoo-mcp-server
Командой платформы
claude mcp add --env PIXOO_IP=<PIXOO_IP> --env PIXOO_SIZE=<PIXOO_SIZE> --env PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> --env PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> --env PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> --transport stdio pixoo-mcp-server -- npx -y @cyanheads/pixoo-mcp-serverВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
codex mcp add pixoo-mcp-server --env PIXOO_IP=<PIXOO_IP> --env PIXOO_SIZE=<PIXOO_SIZE> --env PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> --env PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> --env PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> -- npx -y @cyanheads/pixoo-mcp-serverВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"pixoo-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/pixoo-mcp-server"
],
"env": {
"PIXOO_IP": "<PIXOO_IP>",
"PIXOO_SIZE": "<PIXOO_SIZE>",
"PIXOO_OUTPUT_DIR": "<PIXOO_OUTPUT_DIR>",
"PIXOO_PUSH_MIN_INTERVAL_MS": "<PIXOO_PUSH_MIN_INTERVAL_MS>",
"PIXOO_SERVE_HOST": "<PIXOO_SERVE_HOST>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/pixoo-mcp-server"
],
"env": {
"PIXOO_IP": "<PIXOO_IP>",
"PIXOO_SIZE": "<PIXOO_SIZE>",
"PIXOO_OUTPUT_DIR": "<PIXOO_OUTPUT_DIR>",
"PIXOO_PUSH_MIN_INTERVAL_MS": "<PIXOO_PUSH_MIN_INTERVAL_MS>",
"PIXOO_SERVE_HOST": "<PIXOO_SERVE_HOST>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e PIXOO_IP=<PIXOO_IP> -e PIXOO_SIZE=<PIXOO_SIZE> -e PIXOO_OUTPUT_DIR=<PIXOO_OUTPUT_DIR> -e PIXOO_PUSH_MIN_INTERVAL_MS=<PIXOO_PUSH_MIN_INTERVAL_MS> -e PIXOO_SERVE_HOST=<PIXOO_SERVE_HOST> pixoo-mcp-server npx -y @cyanheads/pixoo-mcp-serverВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о pixoo-mcp-server
Как установить pixoo-mcp-server в Claude Code?
Выполните команду в терминале: claude mcp add pixoo-mcp-server -- npx -y @cyanheads/pixoo-mcp-server.
Какие модели дисплеев поддерживает этот сервер?
Основным целевым устройством выступает Pixoo-64 с разрешением 64 на 64 точки. Экраны Pixoo-16 и Pixoo-32 также поддерживаются.
Что происходит, если символ отсутствует в выбранном шрифте?
В шрифтах standard и compact неподдерживаемые знаки заменяются вопросительным знаком с указанием кода символа в ответе. В шрифте numerals передача любых лишних символов приводит к ошибке валидации.
