ThinkPLC-MCP

ThinkPLC-MCP is a server designed to interface with SIEMENS PLC S7-1500/1200 using their JSON-RPC 2.0 API. It exposes API functionalities as MCP tools, enabling AI assistants and other MCP-compatible clients to interact with the PLC programmatically.

---

🔧 Features

• Connects to a SIEMENS PLC API (Webserver) endpoint
• Provides MCP tools for:
  • ✅ User authentication (login, logout, ChangePassword-user)
  • ✅ Check PLC connectivity (ping)
  • ✅ Retrieve user permissions via Api-GetPermissions after login
  • ✅ Get API version with Api-Version
  • ✅ List available API methods using Api-Browse
  • ✅ Retrieve structure information with Api-GetQuantityStructures
  • ✅ Get password security policies with Api-GetPasswordPolicy
  • ✅ Browse tags and metadata using PlcProgram-Browse
  • ✅ Read single variables via PlcProgram-Read
  • ✅ Write Boolean, Number, or String tags with PlcProgram-Write-*
  • ✅ Read the current CPU operating mode with Plc-ReadOperatingMode
  • ✅ Request a change of operating mode using Plc-RequestChangeOperatingMode
  • ✅ Read the CPU system time (Plc-ReadSystemTime)
  • ✅ Set the CPU system time (Plc-SetSystemTime)
  • ✅ Read available project languages (Project-ReadLanguages)
  • ✅ Browse active alarms (Alarms-Browse)
  • ✅ Acknowledge alarms (Alarms-Acknowledge)
  • ✅ Browse diagnostic buffer entries (DiagnosticBuffer-Browse)
• 🔄 Optional: automatic service account login with token refresh

---

⚙️ Prerequisites

• Node.js (v18.x or later recommended)
• npm (comes bundled with Node.js)
• Access to a running SIEMENS PLC API (Webserver)

---

⚙️ Configuration

This server uses a config.js file written in ES Module syntax.

Example config.js:

export const config = {
  URL: "https://<PLC-IP-Address>/api/jsonrpc", // required
  userName: "your-username", // optional
  pwr: "your-password", // optional
};

🚀 Getting Started

1. Navigate to the project folder:

cd your-project-directory

2. Install dependencies:

npm install

3. Edit config.js as shown above.

4. Start the server

node start

🖥️ Connecting with Claude Desktop

To use this MCP server with Claude AI (desktop version):

1. Find or create the claude_desktop_config.json file (typically in the Claude app config folder).

2. Add or update the following:

{
  "mcpServers": {
    "ThinkPLC-MCP": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:5000/mcp"]
    }
  }
}

4. Ensure @modelcontextprotocol/tools is installed:

npm install -g @modelcontextprotocol/tools