English Français العربية

WAGO PLC

السجل الرسمي أخرى

Read and monitor WAGO PLC parameters over the WDA REST API. Read-only unless writes are allowed.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package wago-plc-mcp-server
Claude Code 
claude mcp add wago-plc -e 'TRANSPORT=<TRANSPORT>' -e 'WAGO_PLC_HOSTS=<WAGO_PLC_HOSTS>' -e 'DEFAULT_PLC_USERNAME=admin' -e 'DEFAULT_PLC_PASSWORD=<your default_plc_password>' -e 'WAGO_TIMEOUT_SECONDS=45' -e 'WAGO_ALLOW_WRITES=false' -e 'AUDIT_LOG_FILE=<AUDIT_LOG_FILE>' -- uvx wago-plc-mcp-server==2.4.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "wago-plc": {
            "command": "uvx",
            "args": [
                "wago-plc-mcp-server==2.4.4"
            ],
            "env": {
                "TRANSPORT": "<TRANSPORT>",
                "WAGO_PLC_HOSTS": "<WAGO_PLC_HOSTS>",
                "DEFAULT_PLC_USERNAME": "admin",
                "DEFAULT_PLC_PASSWORD": "<your default_plc_password>",
                "WAGO_TIMEOUT_SECONDS": "45",
                "WAGO_ALLOW_WRITES": "false",
                "AUDIT_LOG_FILE": "<AUDIT_LOG_FILE>"
            }
        }
    }
}

متغيرات البيئة

  • TRANSPORT إلزامي MCP transport. Fixed to stdio for this package.
  • WAGO_PLC_HOSTS إلزامي Comma-separated IPs of the WAGO PLCs, reachable from this machine
  • DEFAULT_PLC_USERNAME إلزامي WBM username on the PLCs
  • DEFAULT_PLC_PASSWORD إلزامي سري WBM password, same on all listed PLCs
  • WAGO_TIMEOUT_SECONDS WDA request timeout. CC100 needs 45 or more, other controllers work with 15
  • WAGO_ALLOW_WRITES إلزامي true lets the agent change parameters, run methods and upload files. Anything else keeps every PLC read-only
  • AUDIT_LOG_FILE Optional path for the tamper-evident audit log of writes and refusals
OCI package docker.io/wagoalex/wago-plc-mcp-server:2.4.4
Claude Code 
claude mcp add wago-plc -e 'TRANSPORT=<TRANSPORT>' -e 'WAGO_PLC_HOSTS=<WAGO_PLC_HOSTS>' -e 'DEFAULT_PLC_USERNAME=admin' -e 'DEFAULT_PLC_PASSWORD=<your default_plc_password>' -e 'WAGO_TIMEOUT_SECONDS=45' -e 'WAGO_ALLOW_WRITES=false' -e 'AUDIT_LOG_FILE=<AUDIT_LOG_FILE>' -- docker run -i --rm docker.io/wagoalex/wago-plc-mcp-server:2.4.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "wago-plc": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/wagoalex/wago-plc-mcp-server:2.4.4"
            ],
            "env": {
                "TRANSPORT": "<TRANSPORT>",
                "WAGO_PLC_HOSTS": "<WAGO_PLC_HOSTS>",
                "DEFAULT_PLC_USERNAME": "admin",
                "DEFAULT_PLC_PASSWORD": "<your default_plc_password>",
                "WAGO_TIMEOUT_SECONDS": "45",
                "WAGO_ALLOW_WRITES": "false",
                "AUDIT_LOG_FILE": "<AUDIT_LOG_FILE>"
            }
        }
    }
}

متغيرات البيئة

  • TRANSPORT إلزامي MCP transport. Fixed to stdio for this package.
  • WAGO_PLC_HOSTS إلزامي Comma-separated IPs of the WAGO PLCs, reachable from this machine
  • DEFAULT_PLC_USERNAME إلزامي WBM username on the PLCs
  • DEFAULT_PLC_PASSWORD إلزامي سري WBM password, same on all listed PLCs
  • WAGO_TIMEOUT_SECONDS WDA request timeout. CC100 needs 45 or more, other controllers work with 15
  • WAGO_ALLOW_WRITES إلزامي true lets the agent change parameters, run methods and upload files. Anything else keeps every PLC read-only
  • AUDIT_LOG_FILE Optional path for the tamper-evident audit log of writes and refusals

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. wago-plc-mcp-server
  2. Quick start
  3. Try these questions
  4. Safe by default
  5. Next steps
  6. License

wago-plc-mcp-server

This MCP server connects Claude and other AI assistants to WAGO PLCs. You ask a question in plain English. The assistant gets the answer from the PLC. You do not need scripts or parameter IDs.

Quick start

You need Claude Desktop and a PLC that your computer can reach on the network.

  1. Download wago-plc-mcp-server-<version>.mcpb from the latest release.
  2. In Claude Desktop, go to Settings → Extensions.
  3. Drag the .mcpb file onto the window.
  4. In the form, enter the PLC IP address and the WBM password. Then save the form.
  5. Ask Claude: "List my PLCs".

If the installer does not start on Windows, or if you have many PLCs, see Claude Desktop and Claude Code.

Try these questions

What firmware is running on 192.168.1.10?

Check the NTP status on all PLCs.

Show the diagnostic LED states on all PLCs.

For more examples and screen recordings, see Example questions.

Safe by default

  • The server only reads. It refuses all writes until you select Allow writes and method calls.
  • The server refuses reboot, factory reset, and firmware methods. An administrator can allow one exact method.
  • In GitOps mode, the server refuses file uploads. File uploads do not have a pull-request path yet.
  • An audit log records each write, each method call, and each file upload.

For the full rules, see How it works.

Next steps

I want to...Read
Connect many PLCs, install the WAGO skill, or watch the demosClaude Desktop and Claude Code
Know what the server does on my PLCsHow it works
Run one server for a teamDeployment
Review each change in a pull request before it goes to a PLCGitOps
Update firmwareFirmware updates
Configure TLS, API keys, and the audit logSecurity
Find all tools and settingsReference
Find an answer to a common questionFAQ

Supported devices: CC100, PFC100 G2, PFC200 G2, PFC300, Edge Controller, WP400, and TP600. For the tested firmware versions, see Supported hardware.

License

Mozilla Public License 2.0

الأسئلة الشائعة

ما هو WAGO PLC؟

Read and monitor WAGO PLC parameters over the WDA REST API. Read-only unless writes are allowed.

كيف أثبّت WAGO PLC؟

يعمل على جهازك. في Claude Code: claude mcp add wago-plc -e 'TRANSPORT=<TRANSPORT>' -e 'WAGO_PLC_HOSTS=<WAGO_PLC_HOSTS>' -e 'DEFAULT_PLC_USERNAME=admin' -e 'DEFAULT_PLC_PASSWORD=<your default_plc_password>' -e 'WAGO_TIMEOUT_SECONDS=45' -e 'WAGO_ALLOW_WRITES=false' -e 'AUDIT_LOG_FILE=<AUDIT_LOG_FILE>' -- uvx wago-plc-mcp-server==2.4.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج WAGO PLC إلى مفتاح API؟

نعم. يتطلب TRANSPORT, WAGO_PLC_HOSTS, DEFAULT_PLC_USERNAME, DEFAULT_PLC_PASSWORD, WAGO_ALLOW_WRITES، وتضبطها في إعداداته.

هل WAGO PLC مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون WAGO PLC؟

ينشره WagoAlex. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.