Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PLC_MCP_PORTNoPort HTTP exposé par Docker Compose lorsque le port 8000 est déjà occupé.8000
PLC_MCP_ROOTNoRacine OPC UA où explorer.LigneProduction
PLC_MCP_ENDPOINTNoAdresse de l'automate.opc.tcp://localhost:4840/plc-mcp/
PLC_MCP_TIMEZONENoFuseau de l'usine (affichage, « cette nuit »).Europe/Paris
PLC_MCP_ALARM_FOLDERNoDossier des alarmes pour le journal d'arrêts.Alarmes
PLC_MCP_RUN_VARIABLENoVariable de marche pour le journal d'arrêts.Ligne.EnMarche
PLC_MCP_WRITE_POLICYNoListe blanche d'écriture.config/ecriture.yaml
PLC_MCP_NAMESPACE_URINoURI de l'espace de noms OPC UA où explorer.urn:plc-mcp:ligne-production
PLC_MCP_WRITE_ENABLEDNoInterrupteur général des écritures.false
PLC_MCP_CONFIRMATION_TTL_SNoValidité d'un jeton d'écriture.120
PLC_MCP_MAX_HISTORY_POINTSNoBudget de points par historique.120
PLC_MCP_STOP_CODE_VARIABLENoVariable de code d'arrêt pour le journal d'arrêts.Ligne.CodeArret

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Ce serveur donne accès à un automate industriel (ligne de production) via OPC UA.

  • Commence par lister_variables si tu ne connais pas le nom exact d'une variable (format Dossier.Nom).

  • Pour expliquer un arrêt, utilise journal_evenements, puis historique sur les variables suspectes.

  • Les horodatages sont en heure locale de l'usine. « Cette nuit » = periode="nuit".

  • Les écritures sont exceptionnelles : ecrire_variable ne fait que préparer la demande. Montre le récapitulatif à l'utilisateur et n'appelle confirmer_ecriture QUE s'il a explicitement accepté.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
lister_variablesA

Liste les variables de l'automate (chemin, type, unité, plage, description, droits).

    Args:
        dossier: filtre optionnel sur un groupe (ex. « Four2 », « Alarmes »).
    
lire_variableA

Lit la valeur actuelle d'une variable (ex. « Four2.Temperature »), avec unité, horodatage et qualité.

lire_variablesB

Lit plusieurs variables en une seule requête à l'automate.

lister_alarmesA

Liste les alarmes de l'automate, actives en premier, avec l'heure de leur dernier changement.

historiqueA

Historique d'une variable sur une période, résumé pour rester lisible.

    Variables numériques : min, max (avec horodatage), moyenne et une courbe sous-échantillonnée qui
    conserve les pics. Booléens et codes : liste des changements d'état.

    Args:
        chemin: variable, ex. « Four2.Temperature ».
        periode: durée glissante jusqu'à maintenant (« 30min », « 8h », « 2j ») ou « nuit » (22 h → 6 h).
        debut: date ISO 8601 de début (heure locale), prioritaire sur periode. Ex. « 2026-11-19T02:30 ».
        fin: date ISO 8601 de fin (défaut : maintenant).
    
journal_evenementsA

Chronologie des alarmes et des arrêts de la ligne, avec la cause et la durée de chaque arrêt.

    C'est l'outil à utiliser pour répondre à « pourquoi la ligne s'est-elle arrêtée ? ».

    Args:
        periode: « 30min », « 8h », « 2j » ou « nuit » (22 h → 6 h, la plus récente).
        debut: date ISO 8601 de début (heure locale), prioritaire sur periode.
        fin: date ISO 8601 de fin.
    
ecrire_variableA

PRÉPARE l'écriture d'une variable, sans rien écrire. Renvoie un jeton de confirmation.

    Contrôles : serveur en mode écriture, variable en liste blanche, inscriptible par l'automate,
    type et bornes respectés, variation limitée. Montre ensuite le récapitulatif à l'utilisateur
    et attends son accord explicite avant d'appeler confirmer_ecriture.
    
confirmer_ecritureA

ÉCRIT réellement dans l'automate une demande préparée par ecrire_variable.

    À n'appeler qu'après l'accord explicite de l'utilisateur. Le jeton est à usage unique.
    
annuler_ecritureC

Annule une demande d'écriture en attente.

generer_documentationA

Parcourt l'automate et génère la fiche Markdown de toutes ses variables (type, unité, plage, droits, valeur actuelle, description), ainsi que la politique d'écriture.

Prompts

Interactive templates invoked by user choice

NameDescription
diagnostic_arretGuide l'assistant pour expliquer les arrêts de la ligne sur une période.

Resources

Contextual data attached and managed by the client

NameDescription
resource_variablesCatalogue des variables découvertes sur l'automate
resource_documentationFiche Markdown des variables, générée à la volée
resource_policyGarde-fous d'écriture : interrupteur, liste blanche et bornes

TDQS

A3.5/5.0

Scored across 10 tools

Disambiguation4/5

The read surface is cleanly split: lister_variables lists metadata, lire_variable/lire_variables read values, and historique pulls time series; the singular/plural pair is spelled out well in the descriptions. The only real overlap is between lister_alarmes and journal_evenements, which both surface alarm chronologies (the latter adds stops and causes), so an agent could occasionally pick the wrong one. The three-step write flow (ecrire/confirmer/annuler) is explicitly delineated.

Naming Consistency4/5

Eight of ten tools use a verb_noun French pattern (lister_*, lire_*, ecrire_*, confirmer_*, annuler_*, generer_documentation) with consistent lowercase snake_case. The exceptions are 'historique' and 'journal_evenements', which are noun-only names and break the verb-first convention. The style is otherwise uniform and readable.

Tool Count5/5

Ten tools is well within a comfortable scope for a PLC monitoring/control server. Each tool earns its place: the split write-offer/confirm/cancel trio is justified by the safety requirement of operator confirmation, and no tool is redundant filler.

Completeness4/5

The surface covers listing, single and batch reads, history, alarm/event timelines, a guarded write lifecycle, and documentation generation — a solid lifecycle for the domain. Gaps remain: no alarm acknowledgement/reset, no batch write preparation, and no live subscription or polling for value changes. Agents can work around these but they are real omissions.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues