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

Создаёт и удаляет устройства, активы, клиентов и пользователей, сбрасывает оповещения, назначает прошивки; может читать учётные данные устройств.

Настройка клиентов

cursor
{
    "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 для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники