CLI Server

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

@author: Claudio Alarcon [email protected]

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:

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

Using it from Github:

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

Using MCP inspector

Having npm installed, run:

Local repository:

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

From github:

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