Terminal-Control

Terminal-Control

MCP server enabling secure terminal commands, directory navigation, and file operations via a standard interface.

92
Stars
17
Forks
2
Releases

Overview

Terminal Controller for MCP is an MCP server that provides secure remote terminal functionality through a standardized MCP interface. It supports executing shell commands with configurable timeouts and comprehensive output capture (stdout, stderr, and exit status). It enables directory management by navigating, listing, and formatting directory contents. It offers file operations including read, write, update, insert, and delete with row-level precision. The solution includes built-in security measures such as command timeouts, blacklisting of dangerous operations, error isolation, and access restrictions based on granted permissions. It maintains a command history for auditing and quick reference. It is cross-platform, compatible with Windows and UNIX-like systems, and integrates with MCP clients such as Claude Desktop (via UVX or Python direct invocation) and other MCP clients. Installation options include Smithery, PyPI, or source (git clone and setup script). The API exposes tools like execute_command, get_command_history, get_current_directory, change_directory, list_directory, and various file manipulation commands. This design emphasizes safe, auditable remote terminal control within MCP ecosystems.

Details

Owner
GongRzhe
Language
Python
License
MIT License
Updated
2025-12-07

Features

Command Execution

Execute shell commands with configurable timeouts, capturing stdout, stderr, and exit status for reliable results.

Directory Management

Navigate and list directories with clear formatting and contextual details.

Security Measures

Security safeguards including timeout limits, command blacklisting, and isolated execution to prevent risky operations.

Command History

Keeps a searchable history of recent commands for auditing and quick reference.

Cross-Platform Support

Ensures compatibility across Windows and UNIX-like platforms.

File Operations

Supports read, write (overwrite/append), insert, update, and delete operations with row-level granularity.

Audience

MCP clientsConfigure and use Terminal Controller via Claude Desktop or UVX to run remote terminal commands.
DevelopersIntegrate Terminal Controller into MCP-enabled applications to offer remote terminal access.

Tags

MCPterminal-controllerterminalcommand-executiondirectory-managementfile-operationssecuritytimeoutcross-platformPythonCLIMCP-server