Terminal — расширение Claude Desktop для Linux

Расширение для Claude Desktop, которое предоставляет Claude доступ к терминалу, файловой системе и фоновым задачам на вашем локальном компьютере с Linux.

Решает проблему в Linux-версии Claude Desktop, где MCP-серверы в стиле claude_desktop_config.json не загружаются (этот механизм работает только в macOS/Windows); в Linux единственный способ добавить инструменты — через устанавливаемые расширения.

⚠️ Безопасность — прочитайте это в первую очередь

Установка этого расширения предоставляет Claude неограниченный доступ к оболочке (shell) от имени вашей учетной записи пользователя. Все, что вы можете сделать из терминала, Claude может сделать через этот инструмент: читать любые файлы, доступные вашему пользователю, изменять их, устанавливать программное обеспечение, открывать сетевые соединения и т. д.

Относитесь к установке этого расширения так же, как к предоставлению кому-либо SSH-доступа к вашему компьютеру. Не устанавливайте его на машины с конфиденциальными данными, которые вы не хотите показывать Claude, или на общие системы.

Существует минимальный встроенный список запрещенных команд (denylist), который блокирует несколько очевидно деструктивных однострочников (rm -rf /, rm -rf ~, fork-бомбы, dd/mkfs на физических дисках, shutdown/reboot). Это защитная сетка последней надежды, а не песочница. Решительно настроенная команда может легко обойти ее. Она существует лишь для того, чтобы случайная невнимательность не привела к удалению вашей домашней директории.

Чтобы ужесточить ограничения, отредактируйте массив DENYLIST в начале файла server.js и пересоберите расширение. Чтобы полностью их убрать, установите DENYLIST = [] и пересоберите.

Related MCP server: claude-linux-mcp

Что оно делает

Предоставляет Claude 8 инструментов:

Состояние выполнения (расшифровки, временные файлы задач) находится в /tmp/claude-term-mcp/ и очищается при перезагрузке.

Установка

1. Скачайте последний файл Terminal.mcpb со страницы релизов.

2. Откройте Claude Desktop → Settings → Extensions.

3. Прокрутите до раздела Extension Developer внизу. Нажмите Install Extension и выберите скачанный файл Terminal.mcpb.

4. Claude Desktop покажет детали расширения с красным предупреждением "developer info not verified by Anthropic". Убедитесь, что вы доверяете источнику, и нажмите Install.

5. Во время установки Claude Desktop запросит Default working directory — это директория, в которой будут выполняться команды оболочки, если Claude не укажет иную. Выберите папку с вашими основными проектами или оставьте поле пустым, чтобы использовать домашнюю директорию по умолчанию.

6. Вернувшись в All extensions, убедитесь, что переключатель Terminal включен.

7. В чате откройте выбор коннекторов/инструментов и включите Terminal для этого диалога.

Вы можете изменить рабочую директорию по умолчанию позже в разделе Settings → Extensions → Terminal.

Требования

• Claude Desktop ≥ 0.10.0 на Linux (также протестировано на macOS)

• Node.js ≥ 16 (Claude Desktop включает в себя актуальную версию Node для запуска расширений, поэтому системный Node не требуется)

• bash в PATH

Шаг npm install не требуется — расширение представляет собой чистый Node.js без зависимостей.

Конфигурация

Вся конфигурация выполняется через интерфейс Claude Desktop во время установки или в разделе Settings → Extensions → Terminal.

Чтобы настроить список запрещенных команд или другое поведение, отредактируйте server.js и пересоберите (см. ниже).

Известные проблемы

Желтый баннер: "Tool result could not be submitted. The request may have expired or the connection was interrupted." Это сообщение появляется при каждом шаге, который запускает динамическую загрузку инструментов Claude. Ошибка 404 относится к отправке результата поиска инструмента в бэкенд Anthropic, а не к самому MCP-инструменту — ваш вызов инструмента выполняется и возвращает результат корректно сразу после появления баннера. Это косметическая проблема. Та же проблема затрагивает и стандартное расширение Filesystem. Вероятно, это несоответствие протокола клиент↔бэкенд, которое будет исправлено в будущих версиях Claude Desktop.

Сборка из исходного кода

git clone https://github.com/LukeLamb/claude-terminal-mcp
cd claude-terminal-mcp

# Edit whatever you want in server.js / manifest.json.
# If you change the tool surface, update both places.

# Bump the version in manifest.json so Claude Desktop treats the install as an update.

# Build the bundle:
zip -j Terminal.mcpb manifest.json package.json server.js

# Then install Terminal.mcpb via Claude Desktop → Settings → Extensions → Install Extension.

Удаление

Settings → Extensions → All extensions → Terminal → Remove.

Политика конфиденциальности

Никакие данные не покидают ваш компьютер. Это расширение работает полностью локально:

• Сбор данных: Отсутствует. Расширение не связывается с внешними серверами, не отправляет телеметрию и не делает никаких сетевых запросов самостоятельно. Все сетевые вызовы, которые вы наблюдаете, будут инициированы вами через Claude (например, curl, wget, git push).

• Использование и хранение данных: Расшифровки команд (исключая stdin, включая stdout + stderr + код выхода) записываются в /tmp/claude-term-mcp/runs/<timestamp>.log, чтобы Claude мог ссылаться на них позже в том же диалоге. Состояние фоновых задач (команда, pid, файлы логов stdout/stderr, код выхода, статус) записывается в /tmp/claude-term-mcp/jobs/<job-id>/.

• Передача третьим лицам: Отсутствует. Никакие данные не передаются компании Anthropic, автору расширения или любым третьим лицам этим расширением. (Сам Claude Desktop отдельно отправляет входные/выходные данные инструментов в Anthropic как часть обычного процесса чата — это ваши отношения с Anthropic, а не с этим расширением.)

• Хранение: /tmp/claude-term-mcp/ очищается при каждой перезагрузке. Чтобы очистить вручную: rm -rf /tmp/claude-term-mcp.

• Область разрешений: Команды выполняются с правами вашего пользователя — так же, как если бы вы вводили их в терминале.

• Контакты / вопросы: Откройте issue по адресу https://github.com/LukeLamb/claude-terminal-mcp/issues.

Лицензия

MIT. Используйте свободно, указание авторства приветствуется, без гарантий.