Repolode
Enviar
ThingsPanel

ThingsPanel/thingspanel-mcp

Servidor MCP que permite a assistentes de IA, como Claude e GPT, consultar e controlar dispositivos na plataforma IoT ThingsPanel e em dashboards do ThingsVis.

Ver no GitHub
Estrelas
48
Forks
23
Issues abertas
2
Último commit
há 14 dias

O que é?

O ThingsPanel MCP é um servidor Python que disponibiliza as APIs do ThingsPanel e do ThingsVis como ferramentas do Model Context Protocol, permitindo que assistentes compatíveis com MCP interajam em linguagem natural com dados e dispositivos IoT. São 378 ferramentas ao todo: 14 ferramentas específicas para dispositivos, telemetria, dashboards e comandos, além de 364 ferramentas com nomes próprios, geradas a partir de um manifesto de APIs permitidas que abrange 312 operações do ThingsPanel e 52 do ThingsVis.

Cada ferramenta gerada corresponde a um método HTTP e uma rota fixos. Quem faz a chamada informa os parâmetros de caminho, a query, o corpo JSON ou um arquivo para upload. Operações de escrita e controle exigem a flag explícita confirmed=true, e os resultados são retornados como JSON estruturado, com detecção de erros por código de negócio. As credenciais são gerenciadas por meio de perfis nomeados em um arquivo de configuração local ou de variáveis de ambiente, e o serviço conectado sempre aplica as regras de autorização.

Por padrão, o servidor funciona via stdio, com SSE como opção, e pode ser instalado pelo PyPI ou a partir do código-fonte. Há guias de configuração para Codex, Claude Desktop e WorkBuddy.

Recursos principais

  • 01Disponibiliza 378 ferramentas MCP para dispositivos, telemetria, alarmes, dashboards, produtos e uploads.
  • 02As ferramentas geradas correspondem a rotas de API fixas e permitidas, em vez de aceitarem URLs arbitrárias.
  • 03Operações de escrita e controle exigem confirmed=true antes do envio.
  • 04Perfis de credenciais nomeados permitem usar diferentes identidades do ThingsPanel ou do ThingsVis.
  • 05Retorna resultados em JSON estruturado e verifica os códigos de negócio do ThingsPanel.

Casos de uso

  • Permitir que um assistente de IA consulte o status de dispositivos e a telemetria recente em uma instância do ThingsPanel.
  • Consultar alarmes ou grupos de dispositivos por meio de solicitações em linguagem natural.
  • Enviar comandos a dispositivos com uma etapa de aprovação antes da execução.
  • Automatizar consultas a dashboards do ThingsVis a partir de um cliente compatível com MCP.

Tópicos

#mcp#iot#model-context-protocol#python#device-management#telemetry#ai-agent

Perguntas frequentes

O que é thingspanel-mcp?
Servidor MCP que permite a assistentes de IA, como Claude e GPT, consultar e controlar dispositivos na plataforma IoT ThingsPanel e em dashboards do ThingsVis. O ThingsPanel MCP é um servidor Python que disponibiliza as APIs do ThingsPanel e do ThingsVis como ferramentas do Model Context Protocol, permitindo que assistentes compatíveis com MCP interajam em linguagem natural com dados e dispositivos IoT. São 378 ferramentas ao todo: 14 ferramentas específicas para dispositivos, telemetria, dashboards e comandos, além de 364 ferramentas com nomes próprios, geradas a partir de um manifesto de APIs permitidas que abrange 312 operações do ThingsPanel e 52 do ThingsVis.
thingspanel-mcp é gratuito? Qual é a licença?
thingspanel-mcp é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
thingspanel-mcp ainda é mantido?
Manutenção ativa. O último commit de thingspanel-mcp foi em 8 de out. de 2026.
Para que posso usar thingspanel-mcp?
Permitir que um assistente de IA consulte o status de dispositivos e a telemetria recente em uma instância do ThingsPanel. Consultar alarmes ou grupos de dispositivos por meio de solicitações em linguagem natural. Enviar comandos a dispositivos com uma etapa de aprovação antes da execução. Automatizar consultas a dashboards do ThingsVis a partir de um cliente compatível com MCP.
Onde consigo thingspanel-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ThingsPanel/thingspanel-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados