ThingsBoard MCP Server

AI ajanlarını ThingsBoard IoT platformunuza Model Context Protocol (MCP) aracılığıyla bağlayın. Cihazları sorgulayın, varlıkları yönetin, telemetri analiz edin ve operasyonları otomatikleştirin — hepsi doğal dil ile.

Claude Desktop, Cursor, VS Code Copilot, Claude Code ve tüm MCP uyumlu istemciler ile çalışır.

Hızlı Başlangıç

ThingsBoard örneğine (Cloud, EU Cloud, self-hosted CE/PE, veya Edge) ve API anahtarına (ThingsBoard 4.3+) veya kullanıcı adı/parola bilgisine ihtiyacınız vardır.

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

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

{
  "mcp": {
    "servers": {
      "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 mcp add thingsboard \
  -e THINGSBOARD_URL=https://thingsboard.cloud \
  -e THINGSBOARD_API_KEY=YOUR_API_KEY \
  -- docker run -i --rm -e THINGSBOARD_URL -e THINGSBOARD_API_KEY thingsboard/mcp

docker run --rm -p 8000:8000 \
  -e THINGSBOARD_URL=https://thingsboard.cloud \
  -e THINGSBOARD_API_KEY=YOUR_API_KEY \
  -e SPRING_AI_MCP_SERVER_STDIO=false \
  -e SPRING_WEB_APPLICATION_TYPE=servlet \
  thingsboard/mcp

Eski kimlik doğrulama: ThingsBoard sürümünüz 4.3'ten eski ise, THINGSBOARD_API_KEY yerine THINGSBOARD_USERNAME ve THINGSBOARD_PASSWORD kullanın.

Neler Yapabilirsiniz

Doğal dil ile soru sorun ve ThingsBoard örneğinizden yapılandırılmış sonuçlar alın:

Cihazları ve varlıkları sorgulayın	Zaman serileri verilerini analiz edin
Telemetri oluşturun ve kaydedin	Anomali analizi yapın

120+ araç, 10 araç grubunda:

• Cihazlar — oluşturma, güncelleme, silme, listeleme, ad/tür/grup ile arama
• Varlıklar — CRUD, kiracı/müşteri tarafından listeleme, arama
• Müşteriler — CRUD, listeleme, başlık ile arama
• Kullanıcılar — CRUD, listeleme, yönetici/müşteri kullanıcı yönetimi
• Alarmlar — oluşturma, onaylama, temizleme, silme, önem düzeyine göre sorgulama
• Telemetri — öznitelikleri ve zaman serilerini okuma/yazma, toplama, TTL
• İlişkiler — oluşturma, silme, varlık ilişkilerinde gezinme
• OTA Paketleri — yükleme, indirme, cihazlara firmware/yazılım atama
• Varlık Grupları (PE) — grupları yönetme, varlık atama/kaldırma
• Varlık Verisi Sorgusu — öznitelik/telemetri filtreleri ile tüm varlık türlerinde karmaşık filtrelenmiş sorgular

Kurulum

Docker (Önerilen)

docker pull thingsboard/mcp

Docker görüntüsü iki transport modunu destekler:

• STDIO (varsayılan) — sunucuyu alt işlem olarak başlatan istemciler için (Claude Desktop, Cursor, vb.)
• SSE — HTTP üzerinden bağlanan istemciler için

Kullanım örnekleri için Hızlı Başlangıç bölümüne bakın.

İkili Dosyayı İndir

wget https://github.com/thingsboard/mcp-server/releases/download/v2.1.0/thingsboard-mcp-server-2.1.0.jar

Şu şekilde çalıştırın:

# STDIO modu
java -jar thingsboard-mcp-server-2.1.0.jar

# SSE modu
java -Dspring.ai.mcp.server.stdio=false -Dspring.main.web-application-type=servlet -jar thingsboard-mcp-server-2.1.0.jar

{
  "mcpServers": {
    "thingsboard": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/thingsboard-mcp-server-2.1.0.jar"],
      "env": {
        "THINGSBOARD_URL": "https://thingsboard.cloud",
        "THINGSBOARD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Kaynaktan Derle

Java 17+ ve Maven 3.6+ gereklidir.

git clone https://github.com/thingsboard/mcp-server.git
cd mcp-server
mvn clean install -DskipTests
java -jar target/thingsboard-mcp-server-2.1.0.jar

Yapılandırma

Ortam Değişkenleri

Araç Grupları

Sunucu 120+ araç ortaya koymaktadır ve bu, bazı istemcilerin context limitlerini aşabilir. İhtiyacınız olmayan grupları devre dışı bırakın:

Örnek — sınırlı context'i olan istemciler için ~50 araça indirgeyin:

{
  "env": {
    "THINGSBOARD_TOOLS_EDQ": "false",
    "THINGSBOARD_TOOLS_OTA": "false",
    "THINGSBOARD_TOOLS_GROUP": "false",
    "THINGSBOARD_TOOLS_USER": "false"
  }
}

Mevcut Araçlar