iterm-mcp
MCP-сервер для iTerm: агент запускает команды в текущей сессии терминала, читает вывод и шлет управляющие символы
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Выполняет произвольные команды в вашем терминале
- Нет встроенной проверки безопасности команд
- Может запускать и прерывать любые процессы
Установка
В терминале, через 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.
Добавь в конфигурацию 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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything