# 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](https://github.com/Advance-Technologies-Foundation/clio) installed globally:
  ```bash
  dotnet tool install clio -g
  ```
- Registered Creatio environments (via `clio reg-web-app`)

## Installation

```bash
npm install
npm run build
```

## Usage

Start the server:

```bash
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:
   ```bash
   npm start
   ```

2. In another application (Claude Desktop, etc.), reference this server using the `mcp.json` configuration:
   ```json
   {
     "mcpServers": {
       "mcp-clio": {
         "url": "http://localhost:3000/mcp"
       }
     }
   }
   ```

## Development

```bash
# Build TypeScript
npm run build

# Run after building
npm start

# Build and run
npm run dev
```

## License

MIT