MCP-CLIO

A Model Context Protocol (MCP) server that exposes CLIO (Creatio CLI) commands as tools for AI agents.

Features

• Stateless HTTP MCP Server - Streamable HTTP transport for reliable communication
• Environment Management - clio-environment tool for ping and restart operations
• Raw Command Escape Hatch - clio-raw tool for executing any CLIO command
• Extensible Architecture - Modular tool structure ready for additional CLIO commands

Prerequisites

• Node.js >= 18
• CLIO installed globally:

  dotnet tool install clio -g
  

• Registered Creatio environments (via clio reg-web-app)

Installation

npm install
npm run build

Usage

Start the server:

npm start

The server will listen on http://localhost:3000/mcp (configurable via PORT environment variable).

Available Tools

clio-environment

Manage Creatio environments:

• ping - Check environment health
• restart - Restart web application

Parameters:

• command: "ping" | "restart"
• environment: Environment name (registered via clio reg-web-app)

clio-raw

Execute any CLIO command with custom arguments:

Parameters:

• command: Full command string (e.g., "get-pkg-list -e myenv")

Project Structure

mcp-clio/
├── src/
│   ├── index.ts              # Express server entry point
│   ├── server.ts             # MCP server factory
│   ├── clio/
│   │   └── executor.ts       # CLIO command executor
│   └── tools/
│       ├── environment.ts    # Environment management tools
│       ├── raw.ts            # Raw command escape hatch
│       └── *.ts              # Placeholder tool modules
├── package.json
├── tsconfig.json
└── PLAN.md                   # Implementation plan

Testing with MCP Client

The project includes an mcp.json configuration for local testing. To use it:

1. Start the server in one terminal:

   npm start
   

2. In another application (Claude Desktop, etc.), reference this server using the mcp.json configuration:

   {
     "mcpServers": {
       "mcp-clio": {
         "url": "http://localhost:3000/mcp"
       }
     }
   }
   

Development

# Build TypeScript
npm run build

# Run after building
npm start

# Build and run
npm run dev

License

MIT