JPDCL Smart Meter

JPDCL Smart Meter MCP

No oficial, construido por la comunidad y con licencia MIT. Este proyecto no está afiliado ni respaldado por JPDCL, JERC, Genus ni el Gobierno de Jammu y Cachemira.

Acceso solo mediante API al portal del consumidor de JPDCL, al portal de medidores inteligentes de Genus y al libro de contabilidad diario de importación/exportación de JPDCL. No se utiliza automatización de navegador en tiempo de ejecución.

¡Las contribuciones son bienvenidas! :)

Usar el MCP alojado

Agrega esta URL a cualquier cliente MCP que admita HTTP Streamable y OAuth:

https://jpdcl.gododo.in/mcp

No se necesita clave API, indicador de contraseña, encabezado personalizado ni variable de entorno. Tu cliente MCP abre la página de vinculación de cuentas, donde inicias sesión directamente en JPDCL. El servicio alojado expone 24 herramientas de solo lectura a través de la ruta verificada de Azure/WARP, incluidos registros de cuentas, el panel completo del medidor inteligente, intervalos, perfil técnico, informes, alertas, preferencias, soporte, notificaciones, pronósticos y un lector de catálogo protegido. No expone inicio de sesión, inicio de pagos, creación de quejas, cambios de preferencias ni ninguna otra acción que modifique la cuenta.

La única URL pública alojada es https://jpdcl.gododo.in/mcp.

Usar a través de Smithery

Los usuarios de Smithery pueden instalar directamente el servidor publicado habilitado para OAuth:

npx -y smithery@latest auth login
npx -y smithery@latest mcp add ass/jpdcl --id jpdcl

Esto utiliza el mismo flujo de vinculación de cuentas y no coloca las credenciales de JPDCL en la configuración de Smithery.

Ejecutar localmente con npx

Agrega este servidor stdio a cualquier cliente MCP local:

{
  "mcpServers": {
    "JPDCL Smart Meter": {
      "command": "npx",
      "args": ["-y", "jpdcl"]
    }
  }
}

O inícialo directamente:

npx -y jpdcl

En el primer uso, pide al cliente que llame a jpdcl_auth_login. El MCP local guarda su sesión con permisos de archivo privados y actualiza automáticamente las sesiones de JPDCL y de Genus con ámbito de consumidor. Expone 27 herramientas, incluidas las herramientas de desarrollo más amplias y las herramientas de mutación explícitamente protegidas.

También puedes iniciar sesión y usar la CLI directamente:

npx -y jpdcl auth login --save-env
npx -y jpdcl snapshot
npx -y jpdcl smart health
npx -y jpdcl tariff estimate
npx -y jpdcl ledger summary

Usa npx -y jpdcl --help para el árbol de comandos completo. La salida de la CLI es JSON. Agrega --compact antes del comando cuando necesites JSON en una sola línea para scripts, por ejemplo npx -y jpdcl --compact snapshot.

Qué proporciona

• Cuenta del consumidor, facturas, pagos y consumo facturado.
• Lecturas del panel de Genus, intervalos, salud del medidor, alarmas, cortes e informes.
• Registros acumulativos diarios de importación/exportación del medidor y diferencias de período.
• Estimaciones deterministas de tarifas JPDCL con procedencia de fuente y medición.
• Un jpdcl_snapshot normalizado destinado como respuesta predeterminada orientada a IA.

El kit de herramientas etiqueta la evidencia de origen desactualizada o no disponible y no presenta lecturas retrasadas del portal como datos continuamente en vivo.

Seguridad

El MCP alojado es de solo lectura. Los pagos locales, quejas, cambios de perfil, vinculación de cuentas, lecturas bajo demanda, preferencias y eliminación de notificaciones permanecen deshabilitados a menos que se proporcionen tanto JPDCL_ENABLE_MUTATIONS=true como una confirmación explícita.

Nunca confirmes .env, archivos de sesión, ID de consumidor, números de medidor, facturas ni lecturas. Usa npx -y jpdcl auth logout --forget si un dispositivo es compartido o se pierde, y cambia la contraseña de JPDCL si es necesario. Consulta SECURITY.md para informar vulnerabilidades.

Desarrollo

Requiere Bun 1.3+ y Node.js 22.12+:

bun install --frozen-lockfile
bun run typecheck
bun test
bun run build
bun run audit:launcher
bun run audit:http
bun pm pack --dry-run

Las auditorías en vivo del portal utilizan tu propia cuenta privada de JPDCL y nunca deben ejecutarse con credenciales en CI.

Licencia

Publicado bajo la Licencia MIT. Los nombres de portales, servicios y datos siguen siendo propiedad de sus respectivos dueños.