terminal-controller-mcp

terminal-controller-mcp

45

Terminal Controller for MCP is a server designed to allow secure execution of terminal commands and file operations via Model Context Protocol. It focuses on security, cross-platform compatibility, and seamless integration with MCP clients like Claude Desktop.

Overview

Terminal Controller for MCP is a server enabling secure execution of terminal commands, directory navigation, and file system operations through a standardized interface. It features command execution with timeout controls, directory management, security measures against dangerous commands, command history tracking, and cross-platform support.

Features

  • Command Execution: Run terminal commands with comprehensive output capture.
  • Directory Management: Navigate and list directory contents.
  • Security Measures: Built-in safeguards against dangerous operations.
  • Command History: Track recent command executions.
  • Cross-Platform Support: Supports Windows and UNIX systems.
  • File Operations: Read, write, and manage file content with precision.

Usage

Interact using natural language through MCP clients like Claude Desktop: run commands, navigate directories, view history, and manage files.

API Reference

  • execute_command: Run a command with a timeout.
  • get_command_history: Retrieve recent command history.
  • get_current_directory: Get the current directory path.
  • change_directory: Change the working directory.
  • list_directory: List contents of a directory.
  • write_file, read_file, insert_file_content, delete_file_content, update_file_content: Manage file contents.