plc-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PLC_MCP_PORT | No | Port HTTP exposé par Docker Compose lorsque le port 8000 est déjà occupé. | 8000 |
| PLC_MCP_ROOT | No | Racine OPC UA où explorer. | LigneProduction |
| PLC_MCP_ENDPOINT | No | Adresse de l'automate. | opc.tcp://localhost:4840/plc-mcp/ |
| PLC_MCP_TIMEZONE | No | Fuseau de l'usine (affichage, « cette nuit »). | Europe/Paris |
| PLC_MCP_ALARM_FOLDER | No | Dossier des alarmes pour le journal d'arrêts. | Alarmes |
| PLC_MCP_RUN_VARIABLE | No | Variable de marche pour le journal d'arrêts. | Ligne.EnMarche |
| PLC_MCP_WRITE_POLICY | No | Liste blanche d'écriture. | config/ecriture.yaml |
| PLC_MCP_NAMESPACE_URI | No | URI de l'espace de noms OPC UA où explorer. | urn:plc-mcp:ligne-production |
| PLC_MCP_WRITE_ENABLED | No | Interrupteur général des écritures. | false |
| PLC_MCP_CONFIRMATION_TTL_S | No | Validité d'un jeton d'écriture. | 120 |
| PLC_MCP_MAX_HISTORY_POINTS | No | Budget de points par historique. | 120 |
| PLC_MCP_STOP_CODE_VARIABLE | No | Variable 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lister_variablesA | Liste les variables de l'automate (chemin, type, unité, plage, description, droits). |
| 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. |
| journal_evenementsA | Chronologie des alarmes et des arrêts de la ligne, avec la cause et la durée de chaque arrêt. |
| ecrire_variableA | PRÉPARE l'écriture d'une variable, sans rien écrire. Renvoie un jeton de confirmation. |
| confirmer_ecritureA | ÉCRIT réellement dans l'automate une demande préparée par ecrire_variable. |
| 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
| Name | Description |
|---|---|
| diagnostic_arret | Guide l'assistant pour expliquer les arrêts de la ligne sur une période. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_variables | Catalogue des variables découvertes sur l'automate |
| resource_documentation | Fiche Markdown des variables, générée à la volée |
| resource_policy | Garde-fous d'écriture : interrupteur, liste blanche et bornes |
TDQS
Scored across 10 tools
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.
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.
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.
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.