{"type":"mcp_server","name":"terminal-controller-mcp","description":"This repository provides a Model Context Protocol (MCP) server, enabling secure terminal command execution, directory navigation, and file system operations through a standardized interface. It supports cross-platform functionality and offers security measures.","category":"System Tools","language":"Python","stars":99,"forks":2,"owner":"GongRzhe","github_url":"https://github.com/GongRzhe/terminal-controller-mcp","homepage":null,"setup":"## Setup\n\n### Prerequisites\n\n- Python 3.11+\n- An MCP-compatible client (such as Claude Desktop)\n- UV/UVX installed (optional, for UVX method)\n\n### Method 1: PyPI Installation (Recommended)\n\nInstall the package directly from PyPI:\n\n```bash\npip install terminal-controller\n```\n\nOr if you prefer to use UV:\n\n```bash\nuv pip install terminal-controller\n```\n\n### Method 2: From Source\n\nIf you prefer to install from source:\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/GongRzhe/terminal-controller-mcp.git\n   cd terminal-controller-mcp\n   ```\n\n2. Run the setup script:\n   ```bash\n   python setup_mcp.py\n   ```\n\n## Client Configuration\n\n### Claude Desktop\n\nThere are two ways to configure Claude Desktop to use Terminal Controller:\n\n#### Option 1: Using UVX (Recommended)\n\nAdd this to your Claude Desktop configuration file:\n\n```json\n\"terminal-controller\": {\n  \"command\": \"uvx\",\n  \"args\": [\"terminal_controller\"]\n}\n```\n\n#### Option 2: Using Python Directly\n\n```json\n\"terminal-controller\": {\n  \"command\": \"python\",\n  \"args\": [\"-m\", \"terminal_controller\"]\n}\n```\n\nThe configuration path varies by operating system:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Cursor\n\nFor Cursor, use similar configuration settings as Claude Desktop.\n\n### Other MCP Clients\n\nFor other clients, refer to their documentation on how to configure external MCP servers.","tools":"## Available Tools\n\n\t\t1. Command Execution (Run terminal commands with timeout controls and comprehensive output capture)\n\t\t2. Directory Management (Navigate and list directory contents with intuitive formatting)\n\t\t3. Security Measures (Built-in safeguards against dangerous commands and operations)\n\t\t4. Command History (Track and display recent command executions)\n\t\t5. Cross-Platform Support (Works on both Windows and UNIX-based systems)\n\t\t6. `execute_command` (Execute a terminal command and return its results.)\n\t\t7. `get_command_history` (Get recent command execution history.)\n\t\t8. `get_current_directory` (Get the current working directory.)\n\t\t9. `change_directory` (Change the current working directory.)\n\t\t10. `list_directory` (List files and subdirectories in the specified directory.)","faq":null,"created_at":"2025-02-25T16:18:55+00:00","updated_at":"2025-03-28T23:34:27+00:00","source_url":"https://model-context-protocol.com/servers/secure-terminal-command-file-system-server","related_articles":[]}