ThingsPanel MCP

ThingsPanel MCP

ThingsPanel Servidor MCP (Model Context Protocol) da Plataforma IoT.

English | 中文

🚀 Visão Geral do Projeto

O ThingsPanel MCP Server é uma interface inteligente inovadora que permite a você:

• Interagir com dispositivos IoT usando linguagem natural
• Recuperar facilmente informações de dispositivos
• Monitorar desempenho e status de dispositivos em tempo real
• Simplificar comandos de controle de dispositivos
• Analisar dados estatísticos e tendências em toda a plataforma

Público-Alvo

Usuários Pretendidos

• Desenvolvedores de Soluções IoT: Engenheiros e desenvolvedores que constroem soluções na plataforma IoT ThingsPanel e buscam capacidades de integração com IA
• Especialistas em Integração de IA: Profissionais que buscam conectar modelos de IA a sistemas IoT
• Administradores de Sistemas: Profissionais de TI que gerenciam infraestrutura IoT e desejam habilitar análise e controle orientados por IA
• Equipes de Produto: Equipes que constroem produtos que combinam funcionalidades de IoT e IA

Problemas Resolvidos

• Complexidade de Integração: Elimina a necessidade de criar integrações personalizadas entre modelos de IA e plataformas IoT
• Acesso Padronizado: Fornece uma interface consistente para modelos de IA interagirem com dados e dispositivos IoT
• Controle de Segurança: Gerencia autenticação e autorização para acesso de IA a sistemas IoT
• Barreiras Técnicas Reduzidas: Reduz obstáculos técnicos para adicionar capacidades de IA a implantações IoT existentes

Cenários de Aplicação Ideais

• Controle IoT por Linguagem Natural: Permita que usuários controlem dispositivos por meio de assistentes de IA usando linguagem natural
• Análise Inteligente de Dados: Permita que modelos de IA acessem e analisem dados de sensores IoT para obter insights
• Detecção de Anomalias: Conecte modelos de IA a fluxos de dados de dispositivos para detecção de anomalias em tempo real
• Manutenção Preditiva: Habilite manutenção preditiva orientada por IA fornecendo acesso ao histórico de dispositivos
• Relatórios Automatizados: Crie sistemas que possam gerar relatórios e visualizações de dados IoT sob demanda
• Otimização Operacional: Use IA para otimizar operações de dispositivos com base em padrões históricos

✨ Recursos Principais

• 🗣️ Consultas em Linguagem Natural
• 📊 Insights Abrangentes de Dispositivos
• 🌡️ Dados de Telemetria em Tempo Real
• 🎮 Controle Conveniente de Dispositivos
• 📈 Análises em Toda a Plataforma

🛠️ Pré-requisitos

• Python 3.8+
• Conta ThingsPanel
• Chave de API ThingsPanel

📦 Instalação

Opção 1: Instalação via Pip

pip install thingspanel-mcp

Opção 2: Instalação a partir do Código-Fonte

# 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 .

🔐 Configuração

Métodos de Configuração (Escolha Um)

Método 1: Configuração Direta via Linha de Comando (Recomendado)

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

Método 2: Configuração por Variáveis de Ambiente

Se você quiser evitar entrada repetida, defina variáveis de ambiente:

# 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

💡 Dicas:

• As chaves de API geralmente são obtidas no gerenciamento de CHAVE DE API na plataforma ThingsPanel
• A URL base refere-se ao endereço da sua plataforma ThingsPanel, por exemplo, http://demo.thingspanel.cn/
• A configuração via linha de comando é recomendada para proteger informações sensíveis

🖥️ Integração com Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude desktop (claude_desktop_config.json):

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

🤔 Exemplos de Interação

Usando o ThingsPanel MCP Server, você agora pode fazer consultas em linguagem natural, como:

• "Qual é a temperatura atual do meu sensor?"
• "Liste todos os dispositivos ativos"
• "Ligue o sistema de aspersão automático"
• "Mostre a atividade do dispositivo nas últimas 24 horas"

🛡️ Segurança

• Gerenciamento seguro de credenciais
• Usa a API oficial do ThingsPanel
• Suporta autenticação baseada em token

Licença

Apache License 2.0

🌟 Apoie-nos

Se este projeto ajudar você, dê-nos uma estrela no GitHub! ⭐