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