Перейти к содержимому

Shell and Coding agent for Claude and other mcp clients

Интеграция shell и редактирования кода для AI в чат-приложениях вроде Claude, позволяющая выполнять команды и управлять проектами локально.

Python
578 stars

Описание

wcgw — MCP-сервер на Python для интеграции shell и инструментов редактирования кода в чат-АИ, такие как Claude. Поддерживает выполнение команд, чтение/редактирование файлов, инкрементальные правки больших файлов, проверку синтаксиса и режимы (architect для планирования, code-writer для разработки, wcgw для полного доступа). Включает защиты от ошибок, сохранение контекста задач и взаимодействие с терминалом. Идеален для автоматизации разработки, тестирования и отладки локально.

Возможности

Выполнение shell-команд

Запуск команд в терминале с поддержкой интерактива, прерывания и мониторинга статуса, с защитой от одновременных процессов.

Редактирование файлов

Чтение, создание, правка существующих файлов с инкрементальными изменениями, проверкой синтаксиса и защитой от случайных перезаписей.

Режимы работы

Architect для планирования (только чтение), code-writer для целевой разработки и wcgw для полного доступа без ограничений.

Сохранение контекста

Сохранение задач и файлов в один файл для чекпоинтов или передачи знаний между AI, с возможностью возобновления.

Взаимодействие с терминалом

Прикрепление к screen-сессии для мониторинга, прерывания или вмешательства в процессы AI.

Автоматическая загрузка инструкций

Загрузка CLAUDE.md или AGENTS.md из проекта или глобально для настройки поведения AI при инициализации.

Установка

Для Mac и Linux: Установите uv через brew (brew install uv). Создайте/обновите ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "wcgw": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "wcgw"]
    }
  }
}

Перезапустите Claude app.

Для Windows на WSL: Установите uv. Обновите %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "wcgw": {
      "command": "wsl.exe",
      "args": ["uv", "tool", "run", "--python", "3.12", "wcgw"]
    }
  }
}

Если нужно, укажите полный путь к uv.

Опционально: Docker — соберите образ docker build -t wcgw https://github.com/rusiaaman/wcgw.git и обновите config с docker run.

Информация

Язык
Python
Лицензия
Apache License 2.0
GitHub Stars
578

Ссылки