Terminal Controller MCP

🚀 Terminal Controller for MCP

A Model Context Protocol (MCP) server that enables secure terminal command execution, directory navigation, and file system operations through standard interfaces.

🚀 Quick Start

This is a Model Context Protocol (MCP) server, which realizes secure terminal command execution, directory navigation and file system operations through standard interfaces.

✨ Features

• Command Execution: Run terminal commands with timeout control and get comprehensive result feedback.
• Directory Navigation: Easily browse and manipulate the file system structure.
• File System Operations: Efficiently manage files and directories.
• Command Execution: Run system commands and get real-time output and results.
• File Operations: Include functions such as reading, writing, inserting, updating, and deleting.
• Directory Management: Browse the directory structure and perform basic file management operations.
• Security Mechanism: Built-in blacklist mechanism to prevent the execution of dangerous commands.

📦 Installation

Install via Smithery

# Install Terminal Controller for MCP
# Configure the MCP environment
# Start the service

Install using Python package

pip install terminal-controller-mcp

💻 Usage Examples

Example of MCP client configuration

# Example configuration file
{
    "server_address": "localhost",
    "port": 5000,
    "timeout": 3600
}

Command-line usage example

# Run the terminal controller service
python -m terminal_controller

# Or use the uvx tool:
uvx terminal_controller

📚 Documentation

Security Precautions

• All command executions have timeout control, with a default of 3600 seconds.
• Dangerous commands such as rm -rf /, format, and mkfs are prohibited.
• Operation results will be recorded and audited in detail.

Limitations and Deficiencies

• Commands only return results within the timeout period.
• By default, the server has the same file system permissions as the current user.
• Some interactive commands may not work properly because they rely on an interactive interface.

Troubleshooting

1. Ensure that the Python version is 3.11 or higher.
2. Check if the MCP client configuration is correct.
3. Run the terminal controller directly to check for errors:

   python -m terminal_controller
   

4. For uvx-related issues, try:

   uvx terminal_controller
   

📄 License

MIT

⚠️ Important Note

All command executions have timeout control, with a default of 3600 seconds. Dangerous commands such as rm -rf /, format, and mkfs are prohibited. Operation results will be recorded and audited in detail.

💡 Usage Tip

Ensure that the Python version is 3.11 or higher and check if the MCP client configuration is correct.