@codesys/mcp-toolkit 1.1.4 → 1.1.6

package/README.md.enhanced

@@ -1,155 +1,155 @@
-# @codesys/mcp-toolkit
-
-![npm](https://img.shields.io/npm/v/@codesys/mcp-toolkit)
-![License](https://img.shields.io/github/license/yourusername/codesys-mcp-toolkit)
-
-A Model Context Protocol (MCP) server for CODESYS V3 programming environments. This toolkit enables seamless interaction between MCP clients (like Claude Desktop) and CODESYS, allowing automation of project management, POU creation, code editing, and compilation tasks.
-
-<p align="center">
-  <img src="https://github.com/yourusername/codesys-mcp-toolkit/raw/main/docs/assets/diagram.png" alt="CODESYS MCP Toolkit Architecture" width="600">
-</p>
-
-## 🌟 Features
-
-- **Project Management**
-  - Open existing CODESYS projects
-  - Create new projects from templates
-  - Save project changes
-
-- **POU Management**
-  - Create Programs, Function Blocks, and Functions
-  - Set declaration and implementation code
-  - Create properties and methods for Function Blocks
-  - Compile projects
-
-- **MCP Resources**
-  - `codesys://project/status`: Check scripting status and project state
-  - `codesys://project/{+project_path}/structure`: Retrieve project structure
-  - `codesys://project/{+project_path}/pou/{+pou_path}/code`: Read POU code
-
-- **MCP Tools**
-  - `open_project`: Open specified CODESYS project
-  - `create_project`: Create new CODESYS project
-  - `save_project`: Save currently open project
-  - `create_pou`: Create new Program, Function Block, or Function
-  - `set_pou_code`: Update code for a specified POU
-  - `create_property`: Create property in a Function Block
-  - `create_method`: Create method in a Function Block
-  - `compile_project`: Compile the open project
-
-## 📋 Prerequisites
-
-- **CODESYS V3**: A working CODESYS V3 installation (tested with 3.5 SP21) with **Scripting Engine** component enabled
-- **Node.js**: Version 18 or later required
-- **MCP Client**: An MCP-enabled application (e.g., Claude Desktop)
-
-## 🚀 Installation
-
-### Option 1: Install from npm (Recommended)
-
-```bash
-npm install -g @codesys/mcp-toolkit
-```
-
-This installs the package globally, making the `codesys-mcp-toolkit` command available in your terminal.
-
-### Option 2: Install from Source
-
-```bash
-# Clone the repository
-git clone https://github.com/yourusername/codesys-mcp-toolkit.git
-cd codesys-mcp-toolkit
-
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Install globally
-npm install -g .
-```
-
-## 🔧 Configuration
-
-### Claude Desktop Configuration
-
-1. Locate your Claude Desktop configuration file:
-   - Windows: `C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json`
-
-2. Add the CODESYS MCP server entry:
-
-```json
-{
-  "mcpServers": {
-    "codesys_local": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@codesys/mcp-toolkit",
-        "--codesys-path", "C:\\Program Files\\CODESYS 3.5.21.0\\CODESYS\\Common\\CODESYS.exe",
-        "--codesys-profile", "CODESYS V3.5 SP21"
-      ]
-    }
-  }
-}
-```
-
-3. Customize the paths to match your CODESYS installation:
-   - `--codesys-path`: Path to your CODESYS.exe
-   - `--codesys-profile`: Your CODESYS profile name
-
-4. Restart Claude Desktop to apply the changes
-
-## 🛠️ Usage Examples
-
-### Creating a Function Block with Properties
-
-```
-Ask Claude: "Using the CODESYS Local server, please create a Motor Controller function block with Start and Stop methods, plus CurrentSpeed property."
-```
-
-Claude will execute these MCP tool calls:
-1. `create_pou` to create the MotorController Function Block
-2. `create_property` to add the CurrentSpeed property
-3. `create_method` to add Start and Stop methods
-4. `set_pou_code` to implement each method and property
-
-### Opening and Compiling a Project
-
-```
-Ask Claude: "Can you open the project at C:/MyProjects/TestProject.project using CODESYS Local and compile it?"
-```
-
-Claude will:
-1. Use `open_project` to open the specified file
-2. Use `compile_project` to build the application
-
-## 🔍 Troubleshooting
-
-### Common Issues
-
-- **Connection Failures**: Check Claude Desktop logs for error messages
-- **Path Issues**: Ensure CODESYS executable path is correct
-- **Profile Mismatch**: Verify profile name matches exactly
-- **Permission Problems**: Ensure Claude has appropriate permissions
-- **CODESYS Already Running**: Close other CODESYS instances
-
-### Debug Logs
-
-Check logs at:
-- Windows: `C:\Users\<YourUsername>\AppData\Roaming\Claude\logs\`
-
-## 🤝 Contributing
-
-Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
-
-## 📝 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🙏 Acknowledgements
-
-- The [CODESYS](https://www.codesys.com/) team for their scripting engine
-- [Model Context Protocol](https://github.com/m-ld/model-context-protocol) project
-- All contributors who have helped improve this toolkit
+# @codesys/mcp-toolkit
+
+![npm](https://img.shields.io/npm/v/@codesys/mcp-toolkit)
+![License](https://img.shields.io/github/license/yourusername/codesys-mcp-toolkit)
+
+A Model Context Protocol (MCP) server for CODESYS V3 programming environments. This toolkit enables seamless interaction between MCP clients (like Claude Desktop) and CODESYS, allowing automation of project management, POU creation, code editing, and compilation tasks.
+
+<p align="center">
+  <img src="https://github.com/yourusername/codesys-mcp-toolkit/raw/main/docs/assets/diagram.png" alt="CODESYS MCP Toolkit Architecture" width="600">
+</p>
+
+## 🌟 Features
+
+- **Project Management**
+  - Open existing CODESYS projects
+  - Create new projects from templates
+  - Save project changes
+
+- **POU Management**
+  - Create Programs, Function Blocks, and Functions
+  - Set declaration and implementation code
+  - Create properties and methods for Function Blocks
+  - Compile projects
+
+- **MCP Resources**
+  - `codesys://project/status`: Check scripting status and project state
+  - `codesys://project/{+project_path}/structure`: Retrieve project structure
+  - `codesys://project/{+project_path}/pou/{+pou_path}/code`: Read POU code
+
+- **MCP Tools**
+  - `open_project`: Open specified CODESYS project
+  - `create_project`: Create new CODESYS project
+  - `save_project`: Save currently open project
+  - `create_pou`: Create new Program, Function Block, or Function
+  - `set_pou_code`: Update code for a specified POU
+  - `create_property`: Create property in a Function Block
+  - `create_method`: Create method in a Function Block
+  - `compile_project`: Compile the open project
+
+## 📋 Prerequisites
+
+- **CODESYS V3**: A working CODESYS V3 installation (tested with 3.5 SP21) with **Scripting Engine** component enabled
+- **Node.js**: Version 18 or later required
+- **MCP Client**: An MCP-enabled application (e.g., Claude Desktop)
+
+## 🚀 Installation
+
+### Option 1: Install from npm (Recommended)
+
+```bash
+npm install -g @codesys/mcp-toolkit
+```
+
+This installs the package globally, making the `codesys-mcp-toolkit` command available in your terminal.
+
+### Option 2: Install from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/codesys-mcp-toolkit.git
+cd codesys-mcp-toolkit
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Install globally
+npm install -g .
+```
+
+## 🔧 Configuration
+
+### Claude Desktop Configuration
+
+1. Locate your Claude Desktop configuration file:
+   - Windows: `C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json`
+
+2. Add the CODESYS MCP server entry:
+
+```json
+{
+  "mcpServers": {
+    "codesys_local": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@codesys/mcp-toolkit",
+        "--codesys-path", "C:\\Program Files\\CODESYS 3.5.21.0\\CODESYS\\Common\\CODESYS.exe",
+        "--codesys-profile", "CODESYS V3.5 SP21"
+      ]
+    }
+  }
+}
+```
+
+3. Customize the paths to match your CODESYS installation:
+   - `--codesys-path`: Path to your CODESYS.exe
+   - `--codesys-profile`: Your CODESYS profile name
+
+4. Restart Claude Desktop to apply the changes
+
+## 🛠️ Usage Examples
+
+### Creating a Function Block with Properties
+
+```
+Ask Claude: "Using the CODESYS Local server, please create a Motor Controller function block with Start and Stop methods, plus CurrentSpeed property."
+```
+
+Claude will execute these MCP tool calls:
+1. `create_pou` to create the MotorController Function Block
+2. `create_property` to add the CurrentSpeed property
+3. `create_method` to add Start and Stop methods
+4. `set_pou_code` to implement each method and property
+
+### Opening and Compiling a Project
+
+```
+Ask Claude: "Can you open the project at C:/MyProjects/TestProject.project using CODESYS Local and compile it?"
+```
+
+Claude will:
+1. Use `open_project` to open the specified file
+2. Use `compile_project` to build the application
+
+## 🔍 Troubleshooting
+
+### Common Issues
+
+- **Connection Failures**: Check Claude Desktop logs for error messages
+- **Path Issues**: Ensure CODESYS executable path is correct
+- **Profile Mismatch**: Verify profile name matches exactly
+- **Permission Problems**: Ensure Claude has appropriate permissions
+- **CODESYS Already Running**: Close other CODESYS instances
+
+### Debug Logs
+
+Check logs at:
+- Windows: `C:\Users\<YourUsername>\AppData\Roaming\Claude\logs\`
+
+## 🤝 Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgements
+
+- The [CODESYS](https://www.codesys.com/) team for their scripting engine
+- [Model Context Protocol](https://github.com/m-ld/model-context-protocol) project
+- All contributors who have helped improve this toolkit

package/docs/index.md

@@ -1,26 +1,26 @@
-# CODESYS MCP Toolkit Documentation
-
-Welcome to the documentation for the CODESYS MCP Toolkit!
-
-## Overview
-
-The CODESYS MCP Toolkit provides a bridge between Model Context Protocol (MCP) clients and CODESYS V3 programming environments. This toolkit enables seamless interaction for automating project management, POU creation, code editing, and compilation tasks.
-
-## Components
-
-- **MCP Server**: Core component that handles MCP protocol communication
-- **CODESYS Script Integration**: Interface with CODESYS scripting engine
-- **Command-Line Interface**: For direct usage and configuration
-
-## Getting Started
-
-- [Installation](installation.md)
-- [Configuration](configuration.md)
-- [Usage Examples](examples.md)
-- [API Reference](api.md)
-
-## Advanced Topics
-
-- [Contributing Guidelines](../CONTRIBUTING.md)
-- [Troubleshooting](troubleshooting.md)
-- [Custom Extensions](extensions.md)
+# CODESYS MCP Toolkit Documentation
+
+Welcome to the documentation for the CODESYS MCP Toolkit!
+
+## Overview
+
+The CODESYS MCP Toolkit provides a bridge between Model Context Protocol (MCP) clients and CODESYS V3 programming environments. This toolkit enables seamless interaction for automating project management, POU creation, code editing, and compilation tasks.
+
+## Components
+
+- **MCP Server**: Core component that handles MCP protocol communication
+- **CODESYS Script Integration**: Interface with CODESYS scripting engine
+- **Command-Line Interface**: For direct usage and configuration
+
+## Getting Started
+
+- [Installation](installation.md)
+- [Configuration](configuration.md)
+- [Usage Examples](examples.md)
+- [API Reference](api.md)
+
+## Advanced Topics
+
+- [Contributing Guidelines](../CONTRIBUTING.md)
+- [Troubleshooting](troubleshooting.md)
+- [Custom Extensions](extensions.md)

package/docs/installation.md

@@ -1,84 +1,84 @@
-# Installation Guide
-
-This guide covers how to install the CODESYS MCP Toolkit on your system.
-
-## Prerequisites
-
-Before installing, ensure you have:
-
-1. **Node.js**: Version 18 or later
-   - Download from [nodejs.org](https://nodejs.org/)
-   - Verify installation with `node --version`
-
-2. **CODESYS V3**: A working CODESYS V3 installation 
-   - Tested with version 3.5 SP21
-   - Must have the **Scripting Engine** component enabled
-   - Verify by opening CODESYS and checking if scripting commands are available
-
-3. **MCP Client**: An MCP-enabled application (e.g., Claude Desktop)
-
-## Installation Methods
-
-### Method 1: Install from npm (Recommended)
-
-The simplest way to install is directly from npm:
-
-```bash
-npm install -g @codesys/mcp-toolkit
-```
-
-This installs the package globally on your system, making the `codesys-mcp-toolkit` command available in your terminal.
-
-Verify the installation by running:
-
-```bash
-codesys-mcp-toolkit --version
-```
-
-### Method 2: Install from Source
-
-For development or to get the latest unreleased changes:
-
-```bash
-# Clone the repository
-git clone https://github.com/yourusername/codesys-mcp-toolkit.git
-cd codesys-mcp-toolkit
-
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Install globally
-npm install -g .
-```
-
-Verify the installation using the same command as above.
-
-## Next Steps
-
-After installation:
-
-1. [Configure your MCP client](configuration.md) to use the CODESYS MCP Toolkit
-2. Try some [basic examples](examples.md)
-3. Learn about the [available tools and resources](api.md)
-
-## Troubleshooting Installation Issues
-
-### Common Issues
-
-- **Permission errors**: You may need to run npm with administrative privileges
-  ```bash
-  sudo npm install -g @codesys/mcp-toolkit  # On Linux/macOS
-  # or use PowerShell as Administrator on Windows
-  ```
-
-- **Path issues**: Ensure the npm global bin directory is in your PATH
-
-- **Node.js version**: Verify you have Node.js 18 or later
-  ```bash
-  node --version
-  ```
-
-If you encounter other issues, please check the [troubleshooting guide](troubleshooting.md) or [open an issue](https://github.com/yourusername/codesys-mcp-toolkit/issues) on GitHub.
+# Installation Guide
+
+This guide covers how to install the CODESYS MCP Toolkit on your system.
+
+## Prerequisites
+
+Before installing, ensure you have:
+
+1. **Node.js**: Version 18 or later
+   - Download from [nodejs.org](https://nodejs.org/)
+   - Verify installation with `node --version`
+
+2. **CODESYS V3**: A working CODESYS V3 installation 
+   - Tested with version 3.5 SP21
+   - Must have the **Scripting Engine** component enabled
+   - Verify by opening CODESYS and checking if scripting commands are available
+
+3. **MCP Client**: An MCP-enabled application (e.g., Claude Desktop)
+
+## Installation Methods
+
+### Method 1: Install from npm (Recommended)
+
+The simplest way to install is directly from npm:
+
+```bash
+npm install -g @codesys/mcp-toolkit
+```
+
+This installs the package globally on your system, making the `codesys-mcp-toolkit` command available in your terminal.
+
+Verify the installation by running:
+
+```bash
+codesys-mcp-toolkit --version
+```
+
+### Method 2: Install from Source
+
+For development or to get the latest unreleased changes:
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/codesys-mcp-toolkit.git
+cd codesys-mcp-toolkit
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Install globally
+npm install -g .
+```
+
+Verify the installation using the same command as above.
+
+## Next Steps
+
+After installation:
+
+1. [Configure your MCP client](configuration.md) to use the CODESYS MCP Toolkit
+2. Try some [basic examples](examples.md)
+3. Learn about the [available tools and resources](api.md)
+
+## Troubleshooting Installation Issues
+
+### Common Issues
+
+- **Permission errors**: You may need to run npm with administrative privileges
+  ```bash
+  sudo npm install -g @codesys/mcp-toolkit  # On Linux/macOS
+  # or use PowerShell as Administrator on Windows
+  ```
+
+- **Path issues**: Ensure the npm global bin directory is in your PATH
+
+- **Node.js version**: Verify you have Node.js 18 or later
+  ```bash
+  node --version
+  ```
+
+If you encounter other issues, please check the [troubleshooting guide](troubleshooting.md) or [open an issue](https://github.com/yourusername/codesys-mcp-toolkit/issues) on GitHub.