Terminal Controller MCP
by GongRzhe
Secure terminal command execution and file operations through AI assistants
devops Python Intermediate Self-hostable No API key
⭐ 99 stars 📅 Updated: 9mo ago
Description
An MCP server for secure terminal command execution, directory navigation, and file system operations. Provides 10 tools covering command execution with timeout controls, directory navigation, file read/write with row-level precision, and command history tracking. Includes built-in security safeguards with command blacklisting to prevent dangerous operations.
✅ Best for
Teams wanting AI-assisted terminal access with safety controls and file editing capabilities
⏭️ Skip if
You need unrestricted shell access or interactive terminal sessions
💡 Use cases
- Executing shell commands through AI assistants with safety guardrails
- Navigating and listing directory contents
- Reading and editing files with row-level precision
- Tracking command execution history for audit trails
- Automating terminal workflows with AI guidance
👍 Pros
- ✓ Built-in security with dangerous command blacklisting
- ✓ Row-level file operations (read, write, insert, update, delete)
- ✓ Command history tracking for auditability
- ✓ Cross-platform support (Windows and UNIX)
👎 Cons
- ✗ Command blacklist may be too restrictive for some use cases
- ✗ No support for interactive terminal commands
- ✗ Requires Python 3.11+
🔧 Exposed tools (10 tools)
| Tool | Category | Description |
|---|---|---|
| execute_command | command | Run terminal commands with timeout controls and output capture |
| get_command_history | command | Retrieve recent command execution records |
| read_file | file-operations | Read file content with optional row range selection |
| write_file | file-operations | Write or append content to files with verification |
| insert_file_content | file-operations | Insert content at specified row positions |
| update_file_content | file-operations | Update content at specific row positions |
| delete_file_content | file-operations | Remove content from specific row positions |
| get_current_directory | navigation | Return the current working directory path |
| change_directory | navigation | Change to a specified directory path |
| list_directory | navigation | Display directory contents with formatted icons |
💡 Tips & tricks
Use execute_command with timeout for long-running operations. The file tools support row-level precision — use read_file with row ranges to inspect specific sections.
Quick info
- Author
- GongRzhe
- License
- MIT
- Runtime
- Python 3.11+
- Transport
- stdio
- Category
- devops
- Difficulty
- Intermediate
- Self-hostable
- ✅
- Auth
- —
- Docker
- —
- Version
- 1.0.0
- Updated
- Jun 14, 2025
Client compatibility
- ❓ Claude Code
- ❓ Cursor
- ❓ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Platforms
🍎 macOS 🐧 Linux 🪟 Windows