terminal-mcp

magadsm/terminal-mcp

3.1

If you are the rightful owner of terminal-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Terminal Server is a server designed to execute terminal commands via the Model Context Protocol (MCP), integrated with Cursor AI.

MCP Terminal Server (Python)

MCP Terminal Server — это сервер для выполнения терминальных команд через протокол Model Context Protocol (MCP), интегрируемый с Cursor AI. Проект предоставляет инструменты для безопасного и гибкого запуска команд в различных оболочках (bash, cmd, PowerShell) с поддержкой ограничений и метрик.

Возможности

  • Поддерживаемые оболочки: PowerShell (по умолчанию на Windows), cmd, bash
  • Параметры:
    • command — команда для выполнения
    • shell — оболочка (опционально)
    • cwd — рабочая директория (опционально)
    • timeout_seconds — таймаут выполнения (опционально)
  • Транспорт MCP: stdio
  • Метрики и ограничения:
    • Максимальный размер stdout/stderr
    • Ограничение длины команды
    • Ограничение числа одновременных процессов
    • Грейс-период для завершения процессов

Быстрый старт

1. Клонирование и установка зависимостей

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# или .venv\Scripts\activate  # Windows PowerShell
pip install -r requirements.txt

2. Конфигурация Cursor

Создайте файл .cursor/mcp.json в корне TMCP:

{
  "mcpServers": {
    "terminal-mcp": {
      "command": "python",
      "args": ["-m", "TMCP.mcp_terminal.server"]
    }
  }
}

Cursor автоматически запустит MCP сервер через stdio.

3. Запуск вручную (для отладки)

python -m TMCP.mcp_terminal.server

Использование

После запуска сервера инструмент run_command будет доступен в Cursor.

Примеры вызова

  • PowerShell (по умолчанию на Windows):
    • command: Get-ChildItem
  • Через cmd:
    • shell: cmd
    • command: dir
  • С указанием рабочей папки и таймаута:
    • cwd: C:\CursorProjects\TMCP
    • timeout_seconds: 60

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

TMCP/
├── mcp_terminal/
│   ├── __init__.py
│   └── server.py         # Основная логика MCP сервера
├── scripts/
│   └── test_terminal_mcp.py  # Пример теста клиента
├── .cursor/
│   └── mcp.json          # Пример конфигурации для Cursor
├── requirements.txt
├── README.md
└── __init__.py

Для разработчиков

  • Код сервера написан на Python 3.8+
  • Для тестирования используйте скрипты из папки scripts/
  • Для расширения функционала добавляйте новые инструменты через декоратор @server.tool
  • Метрики и кастомные маршруты реализованы для мониторинга и интеграции

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

  • Не передавайте неподтверждённые команды — сервер выполняет любые команды, полученные через MCP.
  • Запускайте сервер без повышенных прав (не от root/Administrator).
  • Используйте переменные окружения для ограничения разрешённых оболочек, директорий и таймаутов.

Лицензия

MIT License

Контакты и поддержка

Автор: magadsm Вопросы и предложения: через GitHub Issues