Terminal Command Runner

Example Use Cases

• 1

  Execute shell commands remotely with timeout control and stream or fetch output from running sessions.

• 2

  Read, write, search, and manipulate files and directories on the host filesystem with safety checks.

• 3

  Manage background processes, list or kill system processes, and retrieve system information programmatically.

Description

This server provides a Model Control Protocol (MCP) implementation that allows agents to run shell commands, manage long-running processes, and perform comprehensive file system operations through a REST API. It includes features for output retrieval, process control, file editing, searching, and system utilities while enforcing safety checks such as command blacklisting and file size limits. The project is designed to integrate with agents like Cursor and includes testing and configuration guidance for quick deployment.