Físico e geoespacialCódigo-fonte público

SCADA MCP Server

Uma plataforma SCADA / de controle industrial para agentes de energia e utilidades ADK-Rust Enterprise. 27 ferramentas MCP cobrindo locais e ativos, telemetria de tags/pontos, leituras em tempo real + um histórico, ciclo de vida de alarmes,…

Abrir o código-fonte Leia o guia oficial ↗

O que ele oferece a um agente

Uma capacidade feita sob medida por trás de uma conexão MCP.

O servidor possui sua lógica de domínio e publica um contrato de ferramenta que um cliente MCP pode descobrir. O ADK-Rust pode carregar esse contrato em um agente, normalizar cada esquema para o provedor de modelo escolhido e manter o ciclo de vida da conexão fora da lógica de negócio do agente.

Locais e ativos — locais por setor (elétrico/gás/água/renovável); ativos com estado operacional (em_serviço/fora_de_serviço/bloqueado/com_falha) e bloqueio/tagout.

Tags / pontos — pontos de telemetria e controle endereçáveis tipados como analógico/status (somente leitura) ou setpoint/controle (gravável), com faixas de engenharia e limites de aviso/crítico.

Telemetria e histórico — ingest_reading registra histórico e automaticamente levanta/limpa alarmes de limite; tag_history e tag_trend para análise.

Alarmes — ciclo de vida de ativo → reconhecido → limpo, por severidade.

Controle — issue_command executa a cadeia de intertravamento e aplica o valor somente se todos passarem; check_interlocks é uma simulação somente leitura.

Interrupções — report_outage faz triagem automática de prioridade (P1 é a mais alta); outage_queue é a fila de trabalho ordenada por prioridade.

Manutenção — ordens de serviço (preventiva/corretiva/inspeção/emergência) com agendamento e atribuição.

Arquitetura

Como SCADA MCP Server se encaixa em um sistema de agente.

O modelo nunca precisa dos detalhes de implementação ou credenciais do sistema por trás do servidor. Ele vê definições de ferramentas revisadas. O cliente MCP lida com descoberta e chamadas, enquanto o servidor mantém a propriedade da validação, política e comunicação com seu sistema de domínio.

Agente ADK-Rust

Escolhe uma capacidade do catálogo de ferramentas revisado.

→

Cliente MCP

Descobre esquemas, envia chamadas e recebe conteúdo tipado.

→

SCADA MCP Server

Valida a solicitação e possui 27 contratos de ferramentas documentados.

→

Sistema de domínio

Mantém a API, dados, credenciais e regras de negócio por trás do servidor.

Conexão: stdio · Framework do servidor: ADK MCP SDK + rmcp

Diagrama de arquitetura de SCADA MCP Server do seu repositório oficial

Catálogo de ferramentas

O que um agente pode pedir para SCADA MCP Server fazer?

Cada ferramenta tem um nome estável, um propósito legível por humanos e um contrato de entrada JSON descoberto durante a inicialização MCP. Classes de risco vêm do manifesto do registro do projeto quando disponível.

27 ferramentas nomeadas

create_site

Registrar um local (subestação/regulador/bomba/solar)

internal write

list_sites

Listar locais por setor

read only

create_asset

Registrar um ativo em um local

internal write

get_asset

Obter um ativo (estado, bloqueio)

read only

list_assets

Listar ativos por local/tipo/estado

read only

set_asset_state

Definir estado operacional do ativo (afeta intertravamentos de controle)

external write

set_lockout

Aplicar/remover bloqueio-tagout (bloqueia controle)

external write

create_tag

Definir uma tag/ponto (analógico/status/setpoint/controle)

internal write

get_tag

Obter valor, faixas e limites de uma tag

read only

list_tags

Listar tags de um ativo com valores ao vivo

read only

ingest_reading

Ingerir uma leitura de telemetria (avaliação automática de alarme)

internal write

tag_history

Histórico de leituras para uma tag

read only

Governança

Entenda o efeito de cada ferramenta.

Uma conexão de servidor herda a autoridade de suas credenciais e do ambiente de implantação. As declarações abaixo vêm do README deste projeto e do manifesto do registro MCP; sua aplicação ainda decide quais ferramentas um agente recebe e onde a aprovação é necessária.

13 read only11 internal write3 external write

Cadeia de intertravamento em cada comando (issue_command), verificada em ordem; o valor é aplicado somente se todos passarem, e um comando rejeitado é registrado mas nunca executado:
Simulação primeiro — check_interlocks (somente leitura) permite que um agente confirme a viabilidade antes de solicitar um comando com aprovação.
Gravações externas com aprovação — issue_command, set_lockout e set_asset_state são external_write + requires_approval no manifesto; nível de risco = "crítico".
Trilha completa de auditoria — cada comando (executado e rejeitado) e mudança de estado é registrada (command_history, audit_log).
Motor de referência — esta é uma implementação de referência em memória. Uma implantação em produção deve também aplicar esses intertravamentos no nível RTU/PLC/campo e via hardware…

Superfície MCP

O que a documentação atual declara.

O MCP pode transportar ferramentas, recursos, prompts, resultados estruturados, progresso, cancelamento e trabalhos de longa duração. Este registro destaca os recursos modernos do protocolo explicitamente mencionados por este repositório.

O README atual concentra-se em sua superfície de ferramentas. Verifique o código-fonte e as notas de versão antes de confiar em capacidades MCP opcionais além da descoberta e invocação de ferramentas.

ADK MCP SDKrmcpManifesto do registro

Instalar e conectar

Siga o ponto de partida documentado do projeto.

Instale o servidor no ambiente que possui suas credenciais e acesso ao domínio. Adicione-o ao seu host MCP, verifique as ferramentas descobertas e restrinja o conjunto de ferramentas antes de entregá-lo a um agente de produção.

Instalar

cargo install mcp-scada

Formato de conexão ADK-Rust

let toolset = McpToolset::from_stdio(
    "mcp-scada",
    ["mcp-scada"],
).await?;

let agent = LlmAgentBuilder::new("agent")
    .tools(toolset.tools().await?)
    .build()?;

Comandos e configurações são extraídos do README público. Confirme pré-requisitos, variáveis de ambiente e opções específicas da versão na documentação oficial antes da implantação.

Documentação oficial

Continue com a fonte de verdade dos mantenedores do projeto.

Esta página fornece um mapa acessível do servidor. O repositório permanece autoritativo para esquemas exatos, pré-requisitos, configuração, exemplos, testes, versões e atualizações de segurança.

Visão Geral ↗README.md CHANGELOG ↗CHANGELOG.md Arquitetura ↗docs/architecture.svg Problemas e suporte ↗problemas no github.com

Continue explorando