iterm-mcp

MCP-сервер для iTerm: агент запускает команды в текущей сессии терминала, читает вывод и шлет управляющие символы

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Выполняет произвольные команды в вашем терминале
  • Нет встроенной проверки безопасности команд
  • Может запускать и прерывать любые процессы
Все причины и проверки

ferrislucas/iterm-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/iterm-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio iterm-mcp -- npx -y iterm-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Выполните в терминале

code --add-mcp '{"name":"iterm-mcp","type":"stdio","command":"npx","args":["-y","iterm-mcp"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "iterm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add iterm-mcp -- npx -y iterm-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.iterm-mcp]
command = "npx"
args = ["-y", "iterm-mcp"]

Если файл уже есть, допишите блок в конец.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "iterm-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "iterm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "iterm-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 936182b.

Текст для агента

Добавь в конфигурацию MCP клиента сервер iterm-mcp с командой npx и аргументами -y iterm-mcp. iTerm2 должен быть запущен.

Другие способы из описания автора
npx -y iterm-mcp

Запуск без установки в систему. Нужны iTerm2 и Node.js 18 и новее.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает агенту доступ к активной сессии iTerm на macOS. Агент пишет команды в терминал, читает нужное число последних строк вывода и отправляет управляющие символы вроде ctrl-c и ctrl-z. Так можно работать с REPL и следить за длинными командами, показывая модели только интересующую часть вывода. Вы делите терминал с моделью и видите каждый шаг. Ставится через npx и рассчитан на Claude Desktop и другие MCP-клиенты, зависимостей мало.

Для кого. Для разработчиков и devops-инженеров на macOS, которым удобно делегировать шаги в терминале агенту.

Подходит, если

  • Нужно, чтобы агент выполнял команды в вашей сессии iTerm
  • Нужна работа с REPL и интерактивными процессами
  • Нужно прерывать команды управляющими символами

Не подходит, если

  • Вы не на macOS или не используете iTerm2
  • Нельзя давать агенту прямое выполнение команд без ограничений
  • Нужна встроенная проверка безопасности команд, ее здесь нет

Пример запроса к агенту

Запусти тесты в текущем терминале и покажи последние строки вывода

Ограничения

Нужны iTerm2 и Node.js версии 18 и новее. Сервер не оценивает безопасность команд: он выполняет то, что решил агент, ответственность на пользователе. Для многошаговых задач может понадобиться прервать модель, если она пошла не туда. Начинать лучше с небольших задач.

Как отключить. Удалите запись iterm-mcp из конфигурации MCP клиента.

MCP

Транспорт
stdio
Авторизация
не нужна

Проверка безопасности

  • Выполняет произвольные команды в вашем терминале
  • Нет встроенной проверки безопасности команд
  • Может запускать и прерывать любые процессы

Коротко о README

README представляет сервер, который дает модели доступ к сессии iTerm с тремя инструментами: запись в терминал, чтение заданного числа строк вывода и отправка управляющего символа. Отдельно вынесены соображения безопасности: встроенных ограничений нет, за выполнение отвечает пользователь. Установка через npx, есть вариант через Smithery, требуются iTerm2 и Node.js 18 и новее. Приведены команды для сборки, разработки и отладки через MCP Inspector. Лицензия MIT.

Частые вопросы

Проверяет ли сервер команды на опасность?

Нет. Встроенных ограничений нет, безопасность на пользователе. Следите за действиями и прерывайте, когда нужно.

Работает ли на Windows или Linux?

Нет, сервер завязан на iTerm2 и работает на macOS.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AIiterm-mcp

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.