ThingsPanel MCP

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows configuration via .env files for storing ThingsPanel API URLs and keys, simplifying environment setup for the MCP server.

  • Provides containerized deployment of the MCP server through Docker, with support for Docker Compose to easily run both the ThingsPanel MCP server and MCP Inspector for debugging.

  • Supports devices using the MQTT protocol for IoT communication, allowing the MCP server to interact with MQTT-enabled devices managed by ThingsPanel.

ThingsPanel MCP

ThingsPanel IoT 플랫폼의 MCP(Model Context Protocol) 서버.

영어 | 중국어

🚀 프로젝트 개요

ThingsPanel MCP 서버는 다음과 같은 기능을 제공하는 혁신적인 지능형 인터페이스입니다.

  • 자연어를 사용하여 IoT 장치와 상호 작용
  • 장치 정보를 쉽게 검색
  • 실시간으로 장치 성능 및 상태를 모니터링합니다.
  • 장치 제어 명령 간소화
  • 플랫폼 전체의 통계 데이터 및 추세 분석

타겟 고객

의도된 사용자

  • IoT 솔루션 개발자 : ThingsPanel IoT 플랫폼에서 솔루션을 구축하고 AI 통합 기능을 모색하는 엔지니어 및 개발자
  • AI 통합 전문가 : AI 모델을 IoT 시스템에 연결하려는 전문가
  • 시스템 관리자 : IoT 인프라를 관리하고 AI 기반 분석 및 제어를 활성화하려는 IT 인력
  • 제품 팀 : IoT와 AI 기능을 결합한 제품을 구축하는 팀

해결된 문제

  • 통합 복잡성 : AI 모델과 IoT 플랫폼 간에 맞춤형 통합을 생성할 필요성을 제거합니다.
  • 표준화된 액세스 : AI 모델이 IoT 데이터 및 장치와 상호 작용할 수 있는 일관된 인터페이스를 제공합니다.
  • 보안 제어 : IoT 시스템에 대한 AI 액세스에 대한 인증 및 승인을 관리합니다.
  • 기술 장벽 감소 : 기존 IoT 배포에 AI 기능을 추가하는 데 있어 발생하는 기술적 장애물을 줄입니다.

이상적인 응용 프로그램 시나리오

  • 자연어 IoT 제어 : 사용자가 자연어를 사용하여 AI 어시스턴트를 통해 기기를 제어할 수 있도록 합니다.
  • 지능형 데이터 분석 : AI 모델이 IoT 센서 데이터에 액세스하고 분석하여 통찰력을 얻도록 허용
  • 이상 감지 : 실시간 이상 감지를 위해 AI 모델을 장치 데이터 스트림에 연결합니다.
  • 예측 유지 관리 : 장치 기록 액세스를 제공하여 AI 기반 예측 유지 관리를 활성화합니다.
  • 자동 보고 : 필요에 따라 IoT 데이터 보고서와 시각화를 생성할 수 있는 시스템을 만듭니다.
  • 운영 최적화 : AI를 사용하여 과거 패턴을 기반으로 장치 운영을 최적화합니다.

✨ 핵심 기능

  • 🗣️ 자연어 쿼리
  • 📊 포괄적인 장치 통찰력
  • 🌡️ 실시간 원격 측정 데이터
  • 🎮 편리한 기기 제어
  • 📈 플랫폼 전체 분석

🛠️ 필수 조건

  • 파이썬 3.8 이상
  • ThingsPanel 계정
  • ThingsPanel API 키

📦 설치

옵션 1: Pip 설치

지엑스피1

옵션 2: 소스 코드 설치

# Clone the repository git clone https://github.com/ThingsPanel/thingspanel-mcp.git # Navigate to project directory cd thingspanel-mcp # Install the project pip install -e .

🔐 구성

구성 방법(하나 선택)

방법 1: 직접 명령줄 구성(권장)

thingspanel-mcp --api-key "Your API Key" --base-url "Your ThingsPanel Base URL"

방법 2: 환경 변수 구성

반복 입력을 피하려면 환경 변수를 설정하세요.

# Add to ~/.bashrc, ~/.zshrc, or corresponding shell config file export THINGSPANEL_API_KEY="Your API Key" export THINGSPANEL_BASE_URL="Your ThingsPanel Base URL" # Then run source ~/.bashrc # or source ~/.zshrc

💡 팁:

  • API 키는 일반적으로 ThingsPanel 플랫폼의 API 키 관리에서 얻습니다.
  • 기본 URL은 ThingsPanel 플랫폼 주소를 나타냅니다(예: http://demo.thingspanel.cn/ .
  • 민감한 정보를 보호하려면 명령줄 구성을 권장합니다.

🖥️ Claude 데스크톱 통합

Claude 데스크톱 구성 파일( claude_desktop_config.json )에 다음을 추가합니다.

{ "mcpServers": { "thingspanel": { "command": "thingspanel-mcp", "args": [ "--api-key", "Your API Key", "--base-url", "Your Base URL" ] } } }

🤔 상호작용 예시

ThingsPanel MCP 서버를 사용하면 다음과 같은 자연어 쿼리를 만들 수 있습니다.

  • "현재 센서의 온도는 얼마입니까?"
  • "모든 활성 장치 나열"
  • "자동 스프링클러 시스템을 켜세요"
  • "지난 24시간 동안의 기기 활동 표시"

🛡️ 보안

  • 보안 자격 증명 관리
  • ThingsPanel 공식 API를 사용합니다
  • 토큰 기반 인증을 지원합니다

특허

아파치 라이선스 2.0

🌟 저희를 지원해주세요

이 프로젝트가 도움이 된다면, GitHub에서 별점을 주세요! ⭐

-
security - not tested
A
license - permissive license
-
quality - not tested

AI 모델을 ThingsPanel IoT 플랫폼에 연결하는 통합 서버로, AI 어시스턴트가 자연어로 IoT 기기와 상호 작용하여 기기 제어, 데이터 검색 및 관리 작업을 수행할 수 있도록 지원합니다.

  1. 🚀 Project Overview
    1. Target Audience
      1. Intended Users
      2. Problems Addressed
      3. Ideal Application Scenarios
    2. ✨ Core Features
      1. 🛠️ Prerequisites
        1. 📦 Installation
          1. Option 1: Pip Installation
          2. Option 2: Source Code Installation
        2. 🔐 Configuration
          1. Configuration Methods (Choose One)
        3. 🖥️ Claude Desktop Integration
          1. 🤔 Interaction Examples
            1. 🛡️ Security
              1. License
                1. 🌟 Support Us
                  ID: rmf6vsucns