thingsboard-mcp
thingsboard-mcp — официальный MCP-сервер от thingsboard. Работа с IoT-платформой ThingsBoard на естественном языке. Ставится через Docker. Лицензия Apache-2.0.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- thingsboard
- Лицензия
- Apache-2.0
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- linux, macos, windows
- Языки
- java
Уровень риска: high
Создаёт и удаляет устройства, активы, клиентов и пользователей, сбрасывает оповещения, назначает прошивки; может читать учётные данные устройств.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"thingsboard\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"THINGSBOARD_URL\", \"-e\", \"THINGSBOARD_API_KEY\", \"thingsboard/mcp\"],\n \"env\": {\n \"THINGSBOARD_URL\": \"https://thingsboard.cloud\",\n \"THINGSBOARD_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}",
"file": "~/.cursor/mcp.json",
"lang": "json",
"notes": "Или .cursor/mcp.json в проекте",
"verified": "docs"
}
Что умеет
ThingsBoard MCP Server подключает ИИ-агентов к IoT-платформе ThingsBoard: на естественном языке можно запрашивать устройства, управлять сущностями, анализировать телеметрию и автоматизировать операции. Сервер работает с ThingsBoard Cloud, EU Cloud, собственными установками CE/PE и Edge. Лицензия Apache 2.0, нужна Java 17 или Docker.
Более 120 инструментов в 10 группах:
- Устройства — создание, изменение, удаление, списки, поиск по имени, типу и группе;
createOrUpsertDevice— основной инструмент для большинства задач,getDeviceCredentialsByDeviceId— учётные данные устройства. - Активы — создание, чтение, изменение и удаление, списки по арендатору и клиенту, поиск.
- Клиенты и пользователи — управление, списки, поиск, администраторы и пользователи клиентов.
- Оповещения (alarms) — создание, подтверждение, сброс, удаление, выборка по важности.
- Телеметрия — чтение и запись атрибутов и временных рядов, агрегация, срок хранения (TTL).
- Связи — создание, удаление и навигация по связям сущностей.
- OTA-пакеты — загрузка, скачивание и назначение прошивок и ПО устройствам.
- Группы сущностей (только PE) — управление группами.
- Entity Data Query — сложные запросы по всем типам сущностей с фильтрами по атрибутам и телеметрии.
Группы можно отключать. 120 инструментов могут превысить лимит контекста некоторых клиентов, поэтому каждую группу выключают переменной: THINGSBOARD_TOOLS_EDQ (40 инструментов), THINGSBOARD_TOOLS_TELEMETRY, THINGSBOARD_TOOLS_DEVICE, THINGSBOARD_TOOLS_ASSET, THINGSBOARD_TOOLS_ALARM, THINGSBOARD_TOOLS_OTA, THINGSBOARD_TOOLS_RELATION, THINGSBOARD_TOOLS_CUSTOMER, THINGSBOARD_TOOLS_USER, THINGSBOARD_TOOLS_GROUP. Пример в README сокращает набор примерно до 50 инструментов.
Два транспорта. STDIO по умолчанию — для клиентов, запускающих сервер как подпроцесс; SSE — для клиентов по HTTP (адрес http://localhost:8000/sse, по умолчанию слушает 127.0.0.1).
Кому подойдёт
- Инженерам IoT — быстрые запросы к устройствам и телеметрии.
- Операторам платформ ThingsBoard — оповещения, клиенты, прошивки.
- Аналитикам — анализ временных рядов и поиск аномалий.
Похожие серверы — в категории автоматизация и IoT.
Установка
Нужны экземпляр ThingsBoard и ключ API (ThingsBoard 4.3 и новее) либо логин и пароль. Для версий старше 4.3 используйте THINGSBOARD_USERNAME и THINGSBOARD_PASSWORD вместо THINGSBOARD_API_KEY. Рекомендуемый способ — Docker (docker pull thingsboard/mcp); есть также JAR-файл из релизов и сборка из исходников через Maven 3.6+. Сессия обновляется каждые 1800 секунд (THINGSBOARD_LOGIN_INTERVAL_SECONDS).
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"thingsboard": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "THINGSBOARD_URL", "-e", "THINGSBOARD_API_KEY", "thingsboard/mcp"],
"env": {
"THINGSBOARD_URL": "https://thingsboard.cloud",
"THINGSBOARD_API_KEY": "YOUR_API_KEY"
}
}
}
}Claude Desktop: claude_desktop_config.json. Cursor: ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (проект). VS Code: settings.json или .vscode/mcp.json.
Проверка
Спросите: «Покажи мои устройства» — сработает инструмент списка устройств арендатора.
Примеры задач
Проанализируй температуру датчиков склада за последние сутки и найди аномалии.Создай устройство «Счётчик-12» и запиши ему тестовую телеметрию.Риски
- Изменения на платформе. Сервер создаёт и удаляет устройства, активы, клиентов и пользователей, сбрасывает оповещения и назначает прошивки устройствам.
- Учётные данные. Ключ API или пароль дают доступ к экземпляру ThingsBoard; инструмент
getDeviceCredentialsByDeviceIdвозвращает учётные данные устройств. - SSE-режим. По умолчанию сервер слушает только
127.0.0.1; не открывайте порт наружу без защиты.
Частые вопросы
Какая версия ThingsBoard нужна для ключа API?
4.3 и новее; для старых версий — логин и пароль.
Что делать, если клиенту не хватает контекста?
Отключите ненужные группы инструментов переменными THINGSBOARD_TOOLS_*.
Можно ли без Docker?
Да, через JAR-файл и Java 17.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
commands
Сервер из UI-TARS-desktop для запуска произвольных команд.
Windows-MCP
Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.
agent-device
Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.
MCP-сервер для анализа сбоев в WinDbg
Анализ аварийных дампов Windows через WinDbg и CDB.