Repolode
Enviar
ThingsPanel

ThingsPanel/thingspanel-mcp

Servidor MCP que permite a asistentes de IA como Claude y GPT consultar y controlar dispositivos en ThingsPanel IoT y los dashboards de ThingsVis.

Ver en GitHub
Estrellas
48
Forks
23
Issues abiertos
2
Último commit
hace 14 días

¿Qué es?

ThingsPanel MCP es un servidor Python que expone las API de ThingsPanel y ThingsVis como herramientas de Model Context Protocol, para que los asistentes compatibles con MCP puedan trabajar con datos y dispositivos IoT usando lenguaje natural. Ofrece 378 herramientas en total: 14 herramientas específicas para dispositivos, telemetría, dashboards y comandos, además de 364 herramientas con nombres individuales, generadas a partir de un manifiesto de API con una lista de permitidos que abarca 312 operaciones de ThingsPanel y 52 de ThingsVis.

Cada herramienta generada corresponde a un método HTTP y una ruta fijos, y quienes la usan proporcionan parámetros de ruta, una consulta, un cuerpo JSON o un archivo para subir. Las operaciones de escritura y control requieren el indicador explícito confirmed=true, y los resultados se devuelven como JSON estructurado, con detección de errores en los códigos de negocio. Las credenciales se administran mediante perfiles con nombre en un archivo de configuración local o variables de entorno, y el servicio conectado siempre aplica la autorización.

El servidor funciona con stdio de forma predeterminada y admite SSE de manera opcional; se puede instalar desde PyPI o a partir del código fuente. Incluye guías de configuración para Codex, Claude Desktop y WorkBuddy.

Funciones clave

  • 01Expone 378 herramientas MCP para dispositivos, telemetría, alarmas, dashboards, productos y cargas de archivos.
  • 02Las herramientas generadas corresponden a rutas de API fijas y permitidas, en lugar de aceptar URL arbitrarias.
  • 03Las operaciones de escritura y control requieren confirmed=true antes de enviarse.
  • 04Los perfiles de credenciales con nombre permiten usar distintas identidades de ThingsPanel o ThingsVis.
  • 05Devuelve resultados en JSON estructurado y comprueba los códigos de negocio de ThingsPanel.

Casos de uso

  • Permitir que un asistente de IA consulte el estado de los dispositivos y la telemetría reciente de una instancia de ThingsPanel.
  • Consultar alarmas o grupos de dispositivos mediante solicitudes en lenguaje natural.
  • Enviar comandos a dispositivos con un paso de aprobación antes de ejecutarlos.
  • Automatizar consultas de dashboards en ThingsVis desde un cliente compatible con MCP.

Temas

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

Preguntas frecuentes

¿Qué es thingspanel-mcp?
Servidor MCP que permite a asistentes de IA como Claude y GPT consultar y controlar dispositivos en ThingsPanel IoT y los dashboards de ThingsVis. ThingsPanel MCP es un servidor Python que expone las API de ThingsPanel y ThingsVis como herramientas de Model Context Protocol, para que los asistentes compatibles con MCP puedan trabajar con datos y dispositivos IoT usando lenguaje natural. Ofrece 378 herramientas en total: 14 herramientas específicas para dispositivos, telemetría, dashboards y comandos, además de 364 herramientas con nombres individuales, generadas a partir de un manifiesto de API con una lista de permitidos que abarca 312 operaciones de ThingsPanel y 52 de ThingsVis.
¿thingspanel-mcp es gratuito? ¿Qué licencia tiene?
thingspanel-mcp es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿thingspanel-mcp sigue mantenido?
Mantenimiento activo. El último commit de thingspanel-mcp fue el 8 oct 2026.
¿Para qué puedo usar thingspanel-mcp?
Permitir que un asistente de IA consulte el estado de los dispositivos y la telemetría reciente de una instancia de ThingsPanel. Consultar alarmas o grupos de dispositivos mediante solicitudes en lenguaje natural. Enviar comandos a dispositivos con un paso de aprobación antes de ejecutarlos. Automatizar consultas de dashboards en ThingsVis desde un cliente compatible con MCP.
¿Dónde consigo thingspanel-mcp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ThingsPanel/thingspanel-mcp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados