terminal-mcp

An MCP (Model Context Protocol) server that lets any LLM execute commands on a local terminal or over SSH — works on Windows and macOS.

• Run commands via native shells (cmd/powershell/bash on Windows, zsh/bash/sh on macOS)

• Execute remote commands over SSH with key-based authentication

• 3-level security model: safe / confirm / blocked

Requirements

• Python 3.11+

• Claude Desktop or any MCP-compatible client

Installation

git clone https://github.com/marttinm/windows-terminal-mcp.git
cd windows-terminal-mcp
pip install -e .

Configure Claude Desktop

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "terminal": {
      "command": "python3",
      "args": ["-m", "terminal_mcp.server"]
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "terminal": {
      "command": "cmd",
      "args": ["/c", "python", "-m", "terminal_mcp.server"]
    }
  }
}

Restart Claude Desktop after saving the config.

Security

Commands fall into three categories:

License

MIT — see LICENSE