Skip to main content
Glama

opus-advisor-mcp

Ein MCP-Server, mit dem Claude Code während einer Aufgabe Opus als strategischen Berater hinzuziehen kann. Führen Sie Ihre Sitzung mit Sonnet oder Haiku aus und eskalieren Sie komplexe Entscheidungen bei Bedarf an Opus – unter Verwendung Ihres bestehenden Claude Code-Abonnements.

Inspiriert von Anthropic's Advisor Strategy.

Funktionsweise

┌─────────────────────────────────────────────┐
│  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                │
└─────────────────────────────────────────────┘

Es werden keine API-Schlüssel benötigt. Der Server ruft die claude CLI auf, die Ihre bestehende Authentifizierung verwendet.

Related MCP server: codex-bridge

Installation

npm install -g opus-advisor-mcp

Oder klonen und lokal bauen:

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

Konfiguration

Fügen Sie dies zur .mcp.json oder ~/.claude/.mcp.json Ihres Projekts hinzu:

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

Falls lokal (nicht global) installiert:

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

Starten Sie Claude Code nach dem Hinzufügen der Konfiguration neu.

Tools

consult_opus

Konsultieren Sie Opus für strategischen Rat.

Parameter

Typ

Standard

Beschreibung

question

string

erforderlich

Die Frage oder das Problem, zu dem Sie Rat benötigen

context

string

optional

Zusätzlicher Kontext, Einschränkungen oder Hintergrund

files

string[]

optional

Dateipfade (relativ zum Projektstammverzeichnis), die als Code-Kontext einbezogen werden sollen

effort

"low"

"medium"

"high"

"medium"

Argumentationsaufwand für Opus

include_history

boolean

true

Frühere Beratungsverläufe für Kontinuität einbeziehen

Beispiel:

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

read_advisor_log

Lesen Sie das Beratungsprotokoll früherer Aufrufe.

Parameter

Typ

Beschreibung

last_n

number

Anzahl der letzten Beratungen, die zurückgegeben werden sollen (für alle weglassen)

read_advisor_meta

Lesen Sie strukturierte Metadaten (Latenz, Token-Anzahl, Aufwandsebenen).

Parameter

Typ

Beschreibung

last_n

number

Anzahl der letzten Einträge, die zurückgegeben werden sollen (für alle weglassen)

clear_advisor_log

Löschen Sie das Beratungsprotokoll und die Metadaten, um neu zu beginnen.

Funktionen

  • Kein API-Schlüssel erforderlich — Nutzt Ihr bestehendes Claude Code-Abonnement über die claude CLI

  • Projektbezogene Protokolle — Der Beratungsverlauf wird pro Projekt unter ~/.opus-advisor/<project>-<hash>/ gespeichert

  • Code-bewusster Kontext — Übergeben Sie Dateipfade direkt; der Server liest sie ein und fügt sie als markierte Codeblöcke ein

  • Beratungskontinuität — Früherer Rat wird als Kontext zurückgeführt, damit Opus auf früheren Entscheidungen aufbauen kann

  • Token-bewusster Verlauf — Der Verlauf ist sowohl durch die Anzahl der Einträge (5) als auch durch das Token-Budget (~6K Token) begrenzt

  • Metadaten-Tracking — Latenz, Token-Schätzungen und Aufwandsebenen werden in advisor-meta.jsonl nachverfolgt

  • Signal-Schutz — Teilweise Ausgaben von beendeten Prozessen werden verworfen und nicht als Rat zurückgegeben

  • Pfad-Traversal-Schutz — Dateizugriffe werden validiert, um innerhalb des Projektstammverzeichnisses zu bleiben

Sicherheit

  • Pfad-Traversal-Schutz: Der Parameter files validiert, dass alle aufgelösten Pfade innerhalb des Projektstammverzeichnisses bleiben. Pfade wie ../../etc/passwd oder absolute Pfade außerhalb des Projekts werden abgelehnt.

  • Binärdateien-Filterung: Gängige Binärdateiendungen (Bilder, ausführbare Dateien, Archive usw.) werden automatisch übersprungen.

  • Keine Shell-Ausführung: Der Server verwendet spawn mit Array-Argumenten und leitet den Prompt über stdin weiter. Es findet keine Shell-Interpolation statt.

  • Nur lokal: Der MCP-Server läuft lokal über stdio. Es werden keine Netzwerkports geöffnet.

  • Beratungsprotokolle: Werden im Klartext unter ~/.opus-advisor/ gespeichert. Diese können Code-Snippets und Fragen aus Ihren Beratungen enthalten. Committen oder teilen Sie diese Dateien nicht, wenn sie sensiblen Code enthalten.

Umgebungsvariablen

Variable

Beschreibung

ADVISOR_LOG_DIR

Überschreibt das Protokollverzeichnis (Standard: ~/.opus-advisor/<project>-<hash>/)

Vergleich mit dem Advisor-Tool von Anthropic

Anthropic's advisor_20260301 ist eine serverseitige API-Funktion, bei der der Berater das vollständige Gesprächsprotokoll innerhalb einer einzigen API-Anfrage sieht. Dieser MCP-Server verfolgt einen anderen Ansatz:

Anthropic Advisor Tool

opus-advisor-mcp

Kontextfreigabe

Vollständiges Protokoll (serverseitig)

Frage + Dateien + Verlauf (clientseitig)

Authentifizierung

API-Schlüssel erforderlich

Nutzt bestehendes Claude Code-Abonnement

Integration

API-Ebene (tools-Array)

MCP-Tool (funktioniert heute in Claude Code)

Persistenz

Keine

Markdown-Protokoll + JSONL-Metadaten

Kosten

Abrechnung pro Token zu Opus-Preisen

Im Abonnement enthalten

Anforderungen

  • Node.js >= 18

  • Claude Code CLI installiert und authentifiziert

Lizenz

MIT

Available Tools

4 tools
clear_advisor_logClear Advisor LogA
Destructive

Clear the consultation log and metadata to start fresh for this project.

Inputs: no named parameters.

consult_opusConsult Opus AdvisorA
Read-only

Consult Claude Opus 4.7 for strategic advice. Opus runs via the Claude Code CLI with your existing subscription — no API key needed. The advisor maintains a per-project consultation log for continuity across calls. History is capped by both entry count (5) and token budget (~6K tokens) to prevent context bloat. Use this for architecture decisions, complex debugging, code review, or any problem that benefits from deeper reasoning.

Inputs: question (required), context, effort, files, +1 more.

read_advisor_logRead Advisor LogA
Read-only

Read the consultation log from prior Opus advisor calls for this project. Useful for reviewing past advice or getting context on decisions already made.

Inputs: last_n.

read_advisor_metaRead Advisor MetadataA
Read-only

Read structured metadata (latency, token counts, effort levels) from all consultations. Useful for understanding cost and performance patterns.

Inputs: last_n.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a uniquely defined purpose: clearing the log, consulting Opus, reading the log, and reading metadata. No two tools overlap in functionality, so an agent can easily distinguish them.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., consult_opus, read_advisor_log). The naming convention is uniform across the entire set.

    Tool Count5/5

    Four tools is a well-scoped count for an advisor MCP server. Each tool addresses a distinct need (consultation, log management, metadata access) without unnecessary extras.

    Completeness4/5

    The tool set covers the core operations: consultation, log reading/clearing, and metadata inspection. A minor gap is the lack of a configuration tool to adjust Opus parameters, but the current surface is sufficient for most workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers