Skip to main content
Glama
deenesjakoruzh
marttinm

windows-terminal-mcp

by marttinm
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Related MCP server: Windows CLI MCP Server

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:

Level

Behavior

Examples

Safe

Executed directly

ls, git, npm, python, curl

Dangerous

Claude warns before executing

rm, rmdir, launchctl, diskutil

Blocked

Always rejected

rm -rf /, format, shutdown, mkfs

License

MIT — see LICENSE

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Windows CLI MCP Server

    simon-ami
    A
    license
    B
    quality
    F
    maintenance
    A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
    9
    809 npm
    269
    MIT

  • SSH MCP Server

    vilasone455
    F
    license
    A
    quality
    D
    maintenance
    A local Model Context Protocol server that allows LLMs to securely execute shell commands on remote Linux and Windows systems via SSH connections.
    6
    23 npm
    2
    -

  • MCP Shell Server

    mako10k
    A
    license
    B
    quality
    A
    maintenance
    A secure MCP server for shell operations, terminal management, and process control, enabling AI assistants to safely execute commands and manage interactive sessions.
    13
    704 npm
    6
    MIT