How do I use Terminal MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Terminal MCP Server list files in the current directory with details" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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).
Используйте переменные окружения для ограничения разрешённых оболочек, директорий и таймаутов.