opus-advisor-mcp

Claude Codeがタスクの途中でOpusを戦略アドバイザーとして活用できるようにするMCPサーバーです。SonnetやHaikuでセッションを実行し、必要に応じてOpusに複雑な意思決定をエスカレーションできます。既存のClaude Codeサブスクリプションを使用するため、追加のAPIキーは不要です。

AnthropicのAdvisor Strategyに触発されています。

仕組み

┌─────────────────────────────────────────────┐
│  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キーは不要です。このサーバーは claude CLI を呼び出し、既存の認証情報を利用します。

インストール

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 CLI経由で既存のClaude Codeサブスクリプションを使用

• プロジェクトごとのログ — 相談履歴はプロジェクトごとに ~/.opus-advisor/<project>-<hash>/ に保存されます

• コード認識コンテキスト — ファイルパスを直接渡すと、サーバーがそれを読み取り、ラベル付きコードブロックとして注入します

• 相談の継続性 — 過去のアドバイスがコンテキストとしてフィードバックされるため、Opusは以前の決定に基づいて構築できます

• トークン認識履歴 — 履歴はエントリ数（5件）とトークン予算（約6Kトークン）の両方で制限されます

• メタデータ追跡 — レイテンシ、トークン見積もり、努力レベルを advisor-meta.jsonl で追跡

• シグナル保護 — 終了したプロセスからの部分的な出力は破棄され、アドバイスとして返されません

• パストラバーサルガード — ファイル読み取りはプロジェクトルート内に留まるよう検証されます

セキュリティ

• パストラバーサル保護: files パラメータは、解決されたすべてのパスがプロジェクトルートディレクトリ内に留まることを検証します。../../etc/passwd のようなパスや、プロジェクト外の絶対パスは拒否されます。

• バイナリファイルフィルタリング: 一般的なバイナリ拡張子（画像、実行ファイル、アーカイブなど）は自動的にスキップされます。

• シェル実行なし: サーバーは配列引数で spawn を使用し、stdin経由でプロンプトをパイプします。シェル補間は発生しません。

• ローカルのみ: MCPサーバーはstdio経由でローカルで実行されます。ネットワークポートは開かれません。

• 相談ログ: ~/.opus-advisor/ にプレーンテキストで保存されます。これらには、相談内容のコードスニペットや質問が含まれる場合があります。機密コードが含まれている場合は、これらのファイルをコミットしたり共有したりしないでください。

環境変数

AnthropicのAdvisorツールとの比較

Anthropicの advisor_20260301 は、サーバーサイドのAPI機能であり、アドバイザーは単一のAPIリクエスト内で会話の全記録を参照します。このMCPサーバーは異なるアプローチをとっています：

要件

• Node.js >= 18

• Claude Code CLIがインストールされ、認証されていること

ライセンス

MIT