JPDCL Smart Meter

MCP somente via API para dados de consumidores e medidores inteligentes da Jammu Power Distribution Corporation Limited, incluindo leituras, contas, pagamentos, saúde do medidor, tarifas e consumo.

GitHub

Documentação

JPDCL Smart Meter MCP

Não oficial, construído pela comunidade e licenciado sob MIT. Este projeto não é afiliado ou endossado pela JPDCL, JERC, Genus ou pelo Governo de Jammu e Caxemira.

Acesso somente via API ao portal do consumidor da JPDCL, ao portal do medidor inteligente da Genus e ao livro-razão diário de importação/exportação de medidores da JPDCL. Nenhuma automação de navegador é usada em tempo de execução.

Contribuições são bem-vindas! :)

Use o MCP hospedado

Adicione esta URL a qualquer cliente MCP que suporte Streamable HTTP e OAuth:

https://jpdcl.gododo.in/mcp

Nenhuma chave de API, flag de senha, cabeçalho personalizado ou variável de ambiente é necessária. Seu cliente MCP abre a página de vinculação de conta, onde você faz login diretamente na JPDCL. O serviço hospedado expõe 24 ferramentas somente leitura através do caminho verificado Azure/WARP, incluindo registros de conta, o painel completo do medidor inteligente, intervalos, perfil técnico, relatórios, alertas, preferências, suporte, notificações, previsões e um leitor de catálogo protegido. Ele não expõe login, iniciação de pagamento, criação de reclamações, alterações de preferências ou qualquer outra ação que modifique a conta.

A única URL hospedada pública é https://jpdcl.gododo.in/mcp.

Use através do Smithery

Usuários do Smithery podem instalar diretamente o servidor publicado habilitado para OAuth:

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

Isso usa o mesmo fluxo de vinculação de conta e não coloca credenciais da JPDCL na configuração do Smithery.

Execute localmente com npx

Adicione este servidor stdio a qualquer cliente MCP local:

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

Ou inicie diretamente:

npx -y jpdcl

No primeiro uso, peça ao cliente para chamar jpdcl_auth_login. O MCP local salva sua sessão com permissões de arquivo privadas e atualiza automaticamente as sessões da JPDCL e da Genus com escopo de consumidor. Ele expõe 27 ferramentas, incluindo as ferramentas de desenvolvimento mais amplas e as ferramentas de mutação explicitamente protegidas.

Você também pode fazer login e usar a CLI diretamente:

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

Use npx -y jpdcl --help para a árvore de comandos completa. A saída da CLI é JSON. Adicione --compact antes do comando quando precisar de JSON em uma linha para scripts, por exemplo npx -y jpdcl --compact snapshot.

O que oferece

  • Conta do consumidor, contas, pagamentos e consumo faturado.
  • Leituras do painel da Genus, intervalos, saúde do medidor, alarmes, interrupções e relatórios.
  • Registros cumulativos diários de importação/exportação do medidor e diferenças de período.
  • Estimativas determinísticas de tarifas da JPDCL com proveniência de fonte e medição.
  • Um jpdcl_snapshot normalizado destinado como resposta padrão voltada para IA.

O kit de ferramentas rotula evidências desatualizadas ou indisponíveis do upstream e não apresenta leituras atrasadas do portal como dados continuamente ao vivo.

Segurança

O MCP hospedado é somente leitura. Pagamentos locais, reclamações, alterações de perfil, vinculação de conta, leituras sob demanda, preferências e exclusão de notificações permanecem desabilitados, a menos que tanto JPDCL_ENABLE_MUTATIONS=true quanto uma confirmação explícita sejam fornecidos.

Nunca envie .env, arquivos de sessão, IDs de consumidor, números de medidores, contas ou leituras. Use npx -y jpdcl auth logout --forget se um dispositivo for compartilhado ou perdido, e altere a senha da JPDCL se necessário. Consulte SECURITY.md para relatar vulnerabilidades.

Desenvolvimento

Requer Bun 1.3+ e 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

Auditorias ao vivo do portal usam sua própria conta privada da JPDCL e nunca devem ser executadas com credenciais em CI.

Licença

Lançado sob a Licença MIT. Nomes de portais, serviços e dados permanecem propriedade de seus respectivos donos.