opus-advisor-mcp
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-mcpOder klonen und lokal bauen:
git clone https://github.com/Divinci-AI/opus-advisor-mcp.git
cd opus-advisor-mcp
npm install
npm run buildKonfiguration
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 | ||
| string | erforderlich | Die Frage oder das Problem, zu dem Sie Rat benötigen | ||
| string | optional | Zusätzlicher Kontext, Einschränkungen oder Hintergrund | ||
| string[] | optional | Dateipfade (relativ zum Projektstammverzeichnis), die als Code-Kontext einbezogen werden sollen | ||
|
|
|
|
| Argumentationsaufwand für Opus |
| boolean |
| 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 |
| 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 |
| 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
claudeCLIProjektbezogene Protokolle — Der Beratungsverlauf wird pro Projekt unter
~/.opus-advisor/<project>-<hash>/gespeichertCode-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.jsonlnachverfolgtSignal-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
filesvalidiert, dass alle aufgelösten Pfade innerhalb des Projektstammverzeichnisses bleiben. Pfade wie../../etc/passwdoder 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
spawnmit 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 |
| Überschreibt das Protokollverzeichnis (Standard: |
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 ( | 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 toolsclear_advisor_logClear Advisor LogADestructive
Clear the consultation log and metadata to start fresh for this project.
Inputs: no named parameters.
consult_opusConsult Opus AdvisorARead-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 LogARead-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 MetadataARead-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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Hosted X Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP server that lets Claude Code consult stronger AI models (o3, Gemini 2.5 Pro, DeepSeek Reasoner) when you need deeper analysis on complex problems.1102 npm148MIT
- AlicenseAqualityDmaintenanceMCP server that lets Claude Code ask GPT Codex for adversarial planning, code review, debugging, research, and risk triage without leaving your project workflow.99 npm2MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude Code to interact with the OpenAI Codex CLI.40 npm20MIT
- AlicenseNot gradedqualityBmaintenanceMCP server enabling Claude to consult Codex (GPT-5.x) mid-task for second opinions, plan/diff review, brainstorming, and codebase exploration via structured debates and permission-controlled interactions.2MIT