claude-octopus

claude-octopus

xiaolaiISC
15 звёзд6 форков
Claude Octopus — это MCP-сервер для запуска нескольких специализированных Claude Code агентов. Каждый агент работает как отдельный инструмент и имеет независимую конфигурацию: модель (Haiku, Sonnet, Opus), набор разрешённых инструментов, системный промпт. Вы можете одновременно использовать строгого ревьюера, который только читает файлы, тестировщика, работающего по TDD, быстрого помощника на Haiku для рутинных вопросов и глубокого аналитика на Opus для сложных задач — всё в одном клиенте. Сервер использует Claude Agent SDK, но скрывает сложность его настройки. Вам достаточно описать конфигурацию в формате JSON. Не нужно переключаться между разными утилитами — все агенты доступны через единый протокол MCP.
ClaudeDevelopment
Открыть на GitHub

Установка

npx -y claude-octopus

Характеристики

Общее

  • СтатусСообщество
  • Разработчикxiaolai
  • ЛицензияISC

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Запуск произвольного количества Claude Code агентов, каждый с уникальной конфигурацией (модель, инструменты, промпт)
  • Пять встроенных MCP-инструментов: отправка задачи (claude_code), продолжение диалога (claude_code_reply), запрос временной шкалы (claude_code_timeline), чтение стенограмм (claude_code_transcript), генерация HTML-отчётов (claude_code_report)
  • Привязывайте к агенту разные модели Claude — от быстрой Haiku до мощной Opus
  • Полный контроль над правами доступа: разрешите агенту только чтение файлов или выполнение команд
  • Полная наблюдаемость рабочих процессов: временные метки, стенограммы сессий, отчёты
  • Интерактивный мастер настройки: npx claude-octopus init — создаёт конфигурацию под ваш MCP-клиент
  • Простая установка через npm, npx или MCP Registry
  • Поддержка переменных среды для тонкой настройки каждого агента (CLAUDE_MODEL, CLAUDE_PERMISSION_MODE, CLAUDE_SYSTEM_PROMPT)
  • Каждый агент работает в своём окружении, изолированно от других

Как подключить

Установите сервер:

npm install claude-octopus

Или запускайте без установки:

npx -y claude-octopus

Добавьте конфигурацию в файл вашего MCP-клиента. Для Claude Desktop это claude_desktop_config.json:

{"mcpServers": {"claude": {"command": "npx", "args": ["claude-octopus@latest"], "env": {"CLAUDE_PERMISSION_MODE": "bypassPermissions"}}}}

После перезапуска клиента появятся пять инструментов по умолчанию.

Чтобы создать несколько агентов, добавьте несколько секций в mcpServers:

{"mcpServers": {"reviewer": {"command": "npx", "args": ["claude-octopus@latest"], "env": {"CLAUDE_PERMISSION_MODE": "bypassPermissions", "CLAUDE_MODEL": "claude-sonnet-4-20250514", "CLAUDE_SYSTEM_PROMPT": "You are a strict code reviewer. Only read files and comment on issues. Do not modify."}}, "test-writer": {"command": "npx", "args": ["claude-octopus@latest"], "env": {"CLAUDE_PERMISSION_MODE": "bypassPermissions", "CLAUDE_MODEL": "claude-sonnet-4-20250514", "CLAUDE_SYSTEM_PROMPT": "You are a test writer. Always write tests before implementation. Follow TDD practices."}}}}

Перезапустите MCP-клиент. Новые агенты появятся как отдельные инструменты.

Примеры запросов

  • «Найди уязвимости в коде модуля авторизации» — агент-ревьюер
  • «Напиши unit-тесты для функции calculateTax с покрытием всех граничных случаев» — агент TDD
  • «Объясни этот алгоритм сортировки по шагам, как будто я новичок» — агент на Opus
  • «Покажи временную шкалу и сгенерируй HTML-отчёт последней сессии» — встроенные инструменты

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: ISC
  • Совместимые клиенты: любые MCP-клиенты, поддерживающие stdio (Claude Desktop, VS Code с продолжением MCP, и другие)

Поделиться