Peterparker57 Clarion Builder MCP Server

🚀 Clarion Builder MCP Server

A MCP server that provides Clarion development and build capabilities. This server enables automated Clarion IDE operations, project compilation, and build management using ClarionCL and MSBuild.

🚀 Quick Start

The Clarion Builder MCP Server is designed to streamline Clarion development and build processes. It offers a range of features and tools to automate tasks and manage projects effectively.

✨ Features

• Execute ClarionCL commands.
• Generate and compile projects.
• Manage templates.
• Import/export dictionaries.
• Handle TXA files.
• Integrate with MSBuild.
• Configure comprehensive builds.

📚 Documentation

Tools

ClarionCL Operations

clarion_cl

Execute ClarionCL commands for IDE tasks.

• action: The ClarionCL action to perform (required).
  • Values:
    • generate: Generate project files.
    • import-txa: Import TXA files.
    • export-txa: Export TXA files.
    • export-dict: Export dictionaries.
    • import-dict: Import dictionaries.
    • register-template: Register templates.
    • unregister-template: Unregister templates.
    • list-templates: List registered templates.
    • register-driver: Register drivers.
• filePath: The full path to the APP/SLN/TXA/DCT file.
• secondaryPath: The auxiliary path for import/export operations.
• version: The Clarion version to use (e.g., "Clarion 11.0 Enterprise Edition").
• conditionalGeneration: Enable conditional generation in the generate action.
• debugGeneration: Enable debug generation in the generate action.
• useWindowsRedirection: Use Windows redirection files (/win switch) (required).
• templateClass: The template class name (for template operations).
• redirectionFile: The redirection file to use (e.g., "Clarion110.red") (required).

Solution Building

compile_solution

Compile a Clarion solution using MSBuild.

• solutionPath: The full path to the .sln file (required).
• projectName: The specific project name to compile (e.g., MyApp.app).
• targetName: The specific target/executable to generate (e.g., MyApp.exe).
• configuration: The build configuration.
  • Values: 'Debug' or 'Release'.
• platform: The target platform.
  • Values: 'Win32' or 'x64'.
• clarionBinPath: The path to the Clarion binary files.
• logFile: The path to the build log file.
• additionalArgs: Additional arguments for MSBuild.

Build options:

• checkIndex: Generate array index check code.
• checkStack: Generate stack access check code.
• lineNumbers: Add line numbers to the MAP file.
• generateMap: Generate a MAP file.
• stackSize: The stack size.
• vid: The debug support level.
  • Values: 'full', 'min', 'off'.
• model: The memory model.
  • Values: 'Dll', 'Lib', 'CustomDll'.
• copyCoreFiles: Copy core DLL files.
• defines: A semicolon-separated list of definitions.

📦 Installation

1. Clone the repository:

git clone https://github.com/yourusername/clarion-builder-mcp-server.git
cd clarion-builder-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

💻 Usage Examples

Development

1. Modify the source code.
2. Run tests:

npm test

3. Build the project:

npm run build

Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a pull request.

📄 License

This project is licensed under the MIT License.