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.

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.

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.

read_advisor_meta

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

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

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:

Anforderungen

• Node.js >= 18

• Claude Code CLI installiert und authentifiziert

Lizenz

MIT