windows-terminal-mcp

Сервер MCP (Model Context Protocol), который позволяет любой LLM выполнять команды в терминале Windows, включая локальные оболочки и удаленные SSH-соединения.

Возможности

• Выполнение команд через cmd, powershell или bash (Git Bash)

• Выполнение удаленных команд по SSH с аутентификацией по ключу

• Трехуровневая модель безопасности (безопасно / подтверждение / заблокировано)

• Настраиваемый тайм-аут для каждой команды

• Работает с Claude Desktop и любым MCP-совместимым клиентом

Related MCP server: Windows CLI MCP Server

Установка

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

Требуется Python 3.11+ на Windows.

Конфигурация

Добавьте сервер в файл конфигурации Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json):

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

Или укажите путь напрямую к скрипту:

{
  "mcpServers": {
    "windows-terminal": {
      "command": "cmd",
      "args": ["/c", "python", "C:/path/to/windows-terminal-mcp/src/windows_terminal_mcp/server.py"]
    }
  }
}

Инструмент: execute_command

Параметры

Ответ

{
  "stdout": "...",
  "stderr": "...",
  "exit_code": 0,
  "execution_time": 0.42
}

Примеры использования

Локальные команды

Run: dir C:\Users
Shell: cmd

Run: Get-Process | Select-Object -First 5
Shell: powershell

Run: git status
Shell: bash

SSH-команды

Run: ubuntu@192.168.1.10 "df -h && uptime"
Shell: ssh
SSH key: ~/.ssh/id_rsa

Run: ubuntu@192.168.1.10 "docker ps"
Shell: ssh
SSH key: ~/.ssh/my_key
Timeout: 30000

Безопасность

Команды классифицируются по трем уровням:

Безопасные — выполняются напрямую echo, dir, type, git, npm, node, python, pip, curl и большинство команд только для чтения.

Опасные — Claude запросит подтверждение перед выполнением del, rmdir, rm, taskkill, net stop, net start, sc delete, reg add и т. д.

Заблокированные — всегда отклоняются format, del /s /q, rd /s /q, reg delete, regedit, shutdown, net user, rm -rf, mkfs, fdisk и аналогичные деструктивные операции.

Разработка

Структура проекта

windows-terminal-mcp/
├── src/windows_terminal_mcp/
│   ├── __init__.py
│   ├── server.py      # MCP server (main entry point)
│   ├── executor.py    # subprocess execution
│   ├── main.py        # simple stdin/stdout handler
│   └── security.py    # command safety checks
├── tests/
│   └── test_windows_terminal_mcp.py
├── pyproject.toml
├── LICENSE
└── README.md

Запуск тестов

pip install pytest
pytest tests/ -v

Использование в качестве модуля Python

from windows_terminal_mcp.server import execute_command

result = execute_command("echo hello", shell="cmd")
print(result)
# {'stdout': 'hello\n', 'stderr': '', 'exit_code': 0, 'execution_time': 0.02}

result = execute_command(
    "ubuntu@192.168.1.10 uptime",
    shell="ssh",
    ssh_key="~/.ssh/id_rsa",
    timeout_ms=10000,
)
print(result)

Журнал изменений

v0.2.0

• Добавлена поддержка SSH с аутентификацией по ключу

• Исправлено формирование SSH-команд (хост и удаленная команда передаются как отдельные аргументы)

• Исправлено раскрытие ~ в путях к SSH-ключам на Windows

• Исправлено наследование stdin, из-за которого SSH зависал внутри процесса MCP-сервера

v0.1.0

• Базовое выполнение команд через cmd, powershell, bash

• Захват stdout/stderr/exit_code

• Трехуровневая модель безопасности

• Модульные тесты

Лицензия

MIT — см. LICENSE