thingsboard/thingsboard-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

99 stars 27 forks 质量 77 趋势 15Apache-2.0

Repository Install

thingsboard/thingsboard-mcp 是从 https://github.com/thingsboard/thingsboard-mcp. 导入的 MCP 服务器候选。

概览

thingsboard/thingsboard-mcp 是从 https://github.com/thingsboard/thingsboard-mcp. 导入的 MCP 服务器候选。

概述（AI 翻译）

通过模型上下文协议（MCP）将AI代理连接到您的ThingsBoard物联网平台。查询设备、管理实体、分析遥测数据并自动化操作——所有这些都通过自然语言实现。

支持Claude Desktop、Cursor、VS Code Copilot、Claude Code及任何兼容MCP的客户端。

快速启动

你需要一个ThingsBoard实例（云端、欧盟云端、自托管CE/PE或Edge）和API密钥（ThingsBoard 4.3+）或用户名/密码。

Claude Desktop

在你的claude_desktop_config.json中添加：

光标

添加到~/.cursor/mcp.json（全局）或.cursor/mcp.json（项目）：

VS Code 副驾驶

在你的VS代码中添加settings.json或.vscode/mcp.json：

克劳德密码

SSE模式（任何基于HTTP的MCP客户端）

启动服务器：

然后将你的MCP客户端指向http://localhost:8000/sse。

遗留认证：如果你的ThingsBoard版本早于4.3，请使用THINGSBOARD_USERNAME和THINGSBOARD_PASSWORD代替THINGSBOARD_API_KEY。

你能做什么

用自然语言提问，并从你的ThingsBoard实例中获得结构化的结果：


查询设备和实体分析时间序列数据

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

ThingsBoard MCP Server

Connect AI agents to your ThingsBoard IoT platform via Model Context Protocol (MCP). Query devices, manage entities, analyze telemetry, and automate operations — all through natural language.

Works with Claude Desktop, Cursor, VS Code Copilot, Claude Code, and any MCP-compatible client.

Quick Start

You need a ThingsBoard instance (Cloud, EU Cloud, self-hosted CE/PE, or Edge) and an API key (ThingsBoard 4.3+) or username/password.

Start the server:

docker run --rm -p 8000:8000 \
  -e THINGSBOARD_URL=https://thingsboard.cloud \
  -e THINGSBOARD_API_KEY=YOUR_API_KEY \

在 GitHub 查看完整 README

安装

docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "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"
      }
    }
  }
}