# MCP CLI Server

An MCP server that provides tools to interact with CLI applications.

@author: Claudio Alarcon clalarco@gmail.com

## Requirements

- `uv` for execution. Check https://docs.astral.sh/uv/ for installation instructions.
- `npm` (optional) to use the MCP inspector. Check https://docs.npmjs.com/ for installation instructions.

## MCP Tools

- `start_process(command: str)`: Start a new process.
- `stop_process(pid: str)`: Stop a running process.
- `is_alive(pid: str)`: Check if a process is running.
- `write_input(pid: str, text: str)`: Send input to a process.
- `read_output(pid: str)`: Read output from a process.
- `get_processes()`: Get a list of all processes.

## MCP Configuration

Local repository configuration:

```json
{
  "mcpServers": {
    "cli": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-cli", "run", "mcp-cli"]
    }
  }
}
```

Using it from Github:

```json
{
  "mcpServers": {
    "cli": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/clalarco/mcp-cli", "mcp-cli"]
    }
  }
}
```

## Using MCP inspector

Having npm installed, run:

Local repository:

```bash
npx -y @modelcontextprotocol/inspector uv run mcp-cli
```

From github:

```bash
npx -y @modelcontextprotocol/inspector uvx --from git+https://github.com/clalarco/mcp-cli mcp-cli
```