drio
Open app

Terminal Controller for MCP

Source

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

Catalog onlyCatalog onlySTDIO

Overview

Terminal Controller for MCP is a server that implements the Model Context Protocol (MCP) to enable secure terminal command execution, directory navigation, and file system operations through a standardized interface.

To use Terminal Controller, set it up by cloning the repository, running the setup script, and configuring your MCP client to interact with the server. You can then use natural language commands to execute terminal operations.

  • Command Execution: Execute terminal commands with timeout controls and output capture. - Directory Management: Navigate and list directory contents with intuitive formatting. - Security Measures: Built-in safeguards against dangerous commands. - Command History: Track and display recent command executions. - Cross-Platform Support: Compatible with both Windows and UNIX-based systems.
  1. Securely executing shell commands from a remote interface.
  2. Managing files and directories through a natural language interface.
  3. Auditing command history for security and compliance.

Add to your AI client

Use these steps to connect Terminal Controller for MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "terminal-controller-mcp-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-controller-mcp-gongrzhe"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "terminal-controller-mcp-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-controller-mcp-gongrzhe"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "terminal-controller-mcp-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-controller-mcp-gongrzhe"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "terminal-controller-mcp-gongrzhe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-controller-mcp-gongrzhe"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "terminal-controller-mcp-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-controller-mcp-gongrzhe"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "terminal-controller-mcp-gongrzhe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-controller-mcp-gongrzhe"
      ]
    }
  }
}

FAQ

Can I use Terminal Controller on any operating system?

Yes! It supports both Windows and UNIX-based systems.

What are the prerequisites for installation?

You need Python 3.10+ and an MCP-compatible client.

How does Terminal Controller ensure security?

It implements timeout controls, command blacklisting, and proper error handling to prevent misuse.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1989,"uuid":"a85cd45c-85f3-4cb7-8284-ecbb4d03dc14","name":"terminal-controller-mcp","title":"Terminal Controller for MCP","description":"A Model Context Protocol (MCP) server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface.","avatar_url":"https://avatars.githubusercontent.com/u/38748229?v=4","created_at":"2025-03-05T07:44:24.839Z","updated_at":"2025-03-12T10:22:28.841Z","status":"created","author_name":"GongRzhe","author_avatar_url":"https://avatars.githubusercontent.com/u/38748229?v=4","tags":"[]","category":"os-automation","is_featured":false,"sort":1,"url":"https://github.com/GongRzhe/terminal-controller-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/e36ffd91d8e6eaf39b1cf1d2ba210c6bb4022a772471bb077f28764e2a6da723/68747470733a2f2f62616467652e6d6370782e6465763f747970653d736572766572","type":null,"metadata":"{\"star\":\"23\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-16 00:45:42\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Os automation