iterm-mcp
Сервер для взаимодействия AI с iTerm сессией, позволяющий выполнять команды и читать вывод для помощи в REPL и CLI.
Описание
iterm-mcp — это сервер Model Context Protocol, предоставляющий доступ к сессии iTerm2. Ключевые особенности: эффективное использование токенов за счёт выборочного чтения вывода, натуральная интеграция для совместной работы с моделью, полный контроль терминала с поддержкой REPL и управляющих символов (Ctrl-C, Ctrl-Z). Разработан на Node.js (версия 18+), с минимальными зависимостями, запускается через npx. Потенциальные применения: делегирование задач AI в терминале, анализ вывода команд, автоматизация CLI для разработчиков и отладка сессий.
Возможности
Эффективное использование токенов
Позволяет модели инспектировать только нужные строки вывода, даже для длительных команд.
Натуральная интеграция с терминалом
Обеспечивает совместный доступ к iTerm для вопросов о экране или делегирования задач.
Полный контроль терминала и REPL
Поддержка запуска REPL, выполнения команд и отправки управляющих символов (Ctrl-C, Ctrl-Z).
Инструмент write_to_terminal
Записывает текст в активный терминал и возвращает количество строк вывода.
Инструмент read_terminal_output
Читает указанное количество последних строк из терминала.
Инструмент send_control_character
Отправляет управляющие символы в терминал для прерывания или управления процессами.
Установка
Установка для Claude Desktop
Добавьте конфигурацию в файл ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%/Claude/claude_desktop_config.json (Windows):
{
"mcpServers": {
"iterm-mcp": {
"command": "npx",
"args": [
"-y",
"iterm-mcp"
]
}
}
}
Автоматическая установка через Smithery
npx -y @smithery/cli install iterm-mcp --client claude
Требования: iTerm2 запущен, Node.js 18+.