opus-advisor-mcp

MCP-сервер, который позволяет Claude Code обращаться к Opus как к стратегическому советнику прямо в процессе выполнения задачи. Запускайте сессию на Sonnet или Haiku и при необходимости передавайте сложные решения Opus, используя вашу существующую подписку Claude Code.

Вдохновлено стратегией советника от Anthropic.

Как это работает

┌─────────────────────────────────────────────┐
│  Claude Code (Sonnet)                       │
│                                             │
│  "I need to decide on the DB schema..."     │
│        │                                    │
│        ▼                                    │
│  calls consult_opus MCP tool                │
│        │                                    │
└────────┼────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────────┐
│  opus-advisor MCP server                    │
│                                             │
│  1. Reads prior consultation history        │
│  2. Reads requested files from disk         │
│  3. Pipes prompt to: claude -p --model opus │
│  4. Logs advice to advisor-log.md           │
│  5. Returns advice to Sonnet                │
└─────────────────────────────────────────────┘

API-ключи не требуются. Сервер вызывает CLI claude, который использует вашу существующую аутентификацию.

Установка

npm install -g opus-advisor-mcp

Или клонируйте и соберите локально:

git clone https://github.com/Divinci-AI/opus-advisor-mcp.git
cd opus-advisor-mcp
npm install
npm run build

Настройка

Добавьте в файл .mcp.json вашего проекта или в ~/.claude/.mcp.json:

{
  "mcpServers": {
    "opus-advisor": {
      "command": "opus-advisor",
      "timeout": 180000
    }
  }
}

Если установлено локально (не глобально):

{
  "mcpServers": {
    "opus-advisor": {
      "command": "node",
      "args": ["/path/to/opus-advisor-mcp/dist/index.js"],
      "timeout": 180000
    }
  }
}

После добавления конфигурации перезапустите Claude Code.

Инструменты

consult_opus

Обратиться к Opus за стратегическим советом.

Пример:

{
  "question": "Is this database migration safe under concurrent writes?",
  "files": ["src/db/migration-042.ts", "src/db/schema.ts"],
  "effort": "high"
}

read_advisor_log

Прочитать журнал консультаций из предыдущих вызовов.

read_advisor_meta

Прочитать структурированные метаданные (задержка, количество токенов, уровни усилий).

clear_advisor_log

Очистить журнал консультаций и метаданные, чтобы начать с чистого листа.

Функции

• API-ключ не требуется — Использует вашу существующую подписку Claude Code через CLI claude

• Журналы для каждого проекта — История консультаций сохраняется для каждого проекта в ~/.opus-advisor/<project>-<hash>/

• Контекст с учетом кода — Передавайте пути к файлам напрямую; сервер считывает и внедряет их как помеченные блоки кода

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

• История с учетом токенов — История ограничена как количеством записей (5), так и бюджетом токенов (~6 тыс. токенов)

• Отслеживание метаданных — Задержка, оценки токенов и уровни усилий отслеживаются в advisor-meta.jsonl

• Защита сигналов — Частичный вывод от завершенных процессов отбрасывается и не возвращается в качестве совета

• Защита от обхода путей — Чтение файлов проверяется на соответствие корню проекта

Безопасность

• Защита от обхода путей: Параметр files проверяет, что все разрешенные пути остаются внутри корневого каталога проекта. Пути вроде ../../etc/passwd или абсолютные пути вне проекта отклоняются.

• Фильтрация бинарных файлов: Распространенные бинарные расширения (изображения, исполняемые файлы, архивы и т. д.) пропускаются автоматически.

• Отсутствие выполнения оболочки: Сервер использует spawn с аргументами в виде массива и передает промпт через stdin. Интерполяция оболочки не происходит.

• Только локально: MCP-сервер работает локально через stdio. Сетевые порты не открываются.

• Журналы консультаций: Хранятся в ~/.opus-advisor/ в виде обычного текста. Они могут содержать фрагменты кода и вопросы из ваших консультаций. Не коммитьте и не распространяйте эти файлы, если они содержат конфиденциальный код.

Переменные окружения

Сравнение с инструментом Advisor от Anthropic

advisor_20260301 от Anthropic — это функция API на стороне сервера, где советник видит полную стенограмму разговора в рамках одного запроса API. Этот MCP-сервер использует другой подход:

Требования

• Node.js >= 18

• Установленный и аутентифицированный CLI Claude Code

Лицензия

MIT