opus-advisor-mcp

Un servidor MCP que permite a Claude Code consultar a Opus como asesor estratégico a mitad de una tarea. Ejecuta tu sesión en Sonnet o Haiku, y escala decisiones complejas a Opus bajo demanda, utilizando tu suscripción existente de Claude Code.

Inspirado en la Estrategia de Asesor de Anthropic.

Cómo funciona

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

No se necesitan claves API. El servidor invoca la CLI claude, que utiliza tu autenticación existente.

Instalación

npm install -g opus-advisor-mcp

O clona y compila localmente:

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

Configuración

Añádelo al archivo .mcp.json de tu proyecto o a ~/.claude/.mcp.json:

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

Si se instaló localmente (no globalmente):

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

Reinicia Claude Code después de añadir la configuración.

Herramientas

consult_opus

Consulta a Opus para obtener asesoramiento estratégico.

Ejemplo:

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

read_advisor_log

Lee el registro de consultas de llamadas anteriores.

read_advisor_meta

Lee metadatos estructurados (latencia, recuento de tokens, niveles de esfuerzo).

clear_advisor_log

Borra el registro de consultas y los metadatos para empezar de cero.

Características

• No requiere clave API — Utiliza tu suscripción existente de Claude Code a través de la CLI claude

• Registros por proyecto — El historial de consultas se almacena por proyecto en ~/.opus-advisor/<project>-<hash>/

• Contexto consciente del código — Pasa rutas de archivo directamente; el servidor las lee y las inyecta como bloques de código etiquetados

• Continuidad de la consulta — El asesoramiento previo se devuelve como contexto para que Opus pueda basarse en decisiones anteriores

• Historial consciente de tokens — El historial está limitado tanto por recuento de entradas (5) como por presupuesto de tokens (~6K tokens)

• Seguimiento de metadatos — Latencia, estimaciones de tokens y niveles de esfuerzo rastreados en advisor-meta.jsonl

• Protección de señales — La salida parcial de procesos terminados se descarta, no se devuelve como asesoramiento

• Protección contra recorrido de rutas — Las lecturas de archivos se validan para permanecer dentro de la raíz del proyecto

Seguridad

• Protección contra recorrido de rutas: El parámetro files valida que todas las rutas resueltas permanezcan dentro del directorio raíz del proyecto. Se rechazan rutas como ../../etc/passwd o rutas absolutas fuera del proyecto.

• Filtrado de archivos binarios: Las extensiones binarias comunes (imágenes, ejecutables, archivos comprimidos, etc.) se omiten automáticamente.

• Sin ejecución de shell: El servidor utiliza spawn con argumentos de matriz y canaliza el prompt a través de stdin. No ocurre ninguna interpolación de shell.

• Solo local: El servidor MCP se ejecuta localmente a través de stdio. No se abren puertos de red.

• Registros de consultas: Almacenados en ~/.opus-advisor/ en texto plano. Estos pueden contener fragmentos de código y preguntas de tus consultas. No confirmes ni compartas estos archivos si contienen código sensible.

Variables de entorno

Cómo se compara con la herramienta de asesoramiento de Anthropic

La advisor_20260301 de Anthropic es una función de API del lado del servidor donde el asesor ve la transcripción completa de la conversación dentro de una única solicitud de API. Este servidor MCP es un enfoque diferente:

Requisitos

• Node.js >= 18

• CLI de Claude Code instalada y autenticada

Licencia

MIT