Awesome MCP › Software Development

GongRzhe/terminal-controller-mcp

⭐ 97 Python added to this list on 2025-05-14 repository created 2025-02-25

Terminal Controller for MCP gives an assistant control of a shell and the local file system through a standardised set of tools. Command execution runs terminal commands with timeout controls and captures both output streams, so a hung command fails rather than blocking indefinitely. Directory tools navigate the file system and list contents in a readable form. File operations are more granular than whole-file read and write: content can be read, written, updated, inserted and deleted at row-level precision, which lets a model change one line of a configuration file without rewriting it and risking the rest. A command-history feature records and displays recent executions, giving the user a record of what was run. Safeguards are built in against commands recognised as dangerous, though as with any denylist these are a mitigation rather than a boundary. It works on both Windows and UNIX-like systems, is written in Python, and is installable through Smithery for Claude Desktop. The GitHub repository is archived and no longer maintained, which is worth weighing given that the server grants shell and file-write access — an unmaintained component in that position will not receive fixes. The audience is people wanting local machine control from an assistant, best treated as a reference implementation.

https://github.com/GongRzhe/terminal-controller-mcp

mcpterminalshellpythonfile-operationscommand-executioncross-platformarchived