Enables sending prompts and files to Gemini 2.5 Pro with support for large context (up to 1M tokens). Offers two main tools: 'second-opinion' for getting model responses on file content, and 'expert-review' for receiving code change suggestions formatted as SEARCH/REPLACE blocks.
mcp-sageEin MCP-Server (Model Context Protocol), der Tools zum Senden von Eingabeaufforderungen an OpenAIs O3-Modell oder Googles Gemini 2.5 Pro basierend auf der Token-Anzahl bereitstellt. Die Tools betten alle referenzierten Dateipfade (rekursiv für Ordner) in die Eingabeaufforderung ein. Dies ist nützlich, um Zweitmeinungen oder detaillierte Codeüberprüfungen von einem Modell einzuholen, das große Mengen Kontext präzise verarbeiten kann.
Ich nutze Claude Code intensiv. Es ist ein großartiges Produkt, das sich gut für meinen Workflow eignet. Neuere Modelle mit großem Kontextumfang scheinen jedoch besonders nützlich für komplexere Codebasen zu sein, die mehr Kontext benötigen. Dadurch kann ich Claude Code weiterhin als Entwicklungstool verwenden und gleichzeitig die umfangreichen Kontextfunktionen von O3 und Gemini 2.5 Pro nutzen, um den begrenzten Kontext von Claude Code zu erweitern.
Der Server wählt automatisch das entsprechende Modell basierend auf der Token-Anzahl und den verfügbaren API-Schlüsseln aus:
Fallback-Verhalten:
Dieses Projekt ist von zwei anderen Open-Source-Projekten inspiriert:
Dieses Projekt implementiert einen MCP-Server, der drei Tools bereitstellt:
sage-opinionsage-reviewsage-planDas Tool sage-plan fragt nicht ein einzelnes Modell nach einem Plan. Stattdessen orchestriert es eine strukturierte Debatte , die über eine oder mehrere Runden läuft, und bittet dann ein separates Richtermodell (oder dasselbe Modell im CoRT-Modus), den Gewinner auszuwählen.
Wichtige Phasen der Multimodell-Debatte:
Einrichtungsphase
Runde 1
Runden 2 bis N (N ist standardmäßig 3)
Urteilsphase
Wenn nur ein Modell verfügbar ist, wird ein Chain of Recursive Thoughts (CoRT) -Ansatz verwendet:
| Phase / Funktionalität | Code-Speicherort | Hinweise |
|---|---|---|
| Eingabeaufforderungen zur Generierung | prompts/debatePrompts.generatePrompt | Fügt die Überschrift „# Implementierungsplan (Modell X)“ hinzu. |
| Kritikanregungen | prompts/debatePrompts.critiquePrompt | Verwendet die Abschnitte „## Kritik an Plan {ID}“ |
| Syntheseaufforderungen | prompts/debatePrompts.synthesizePrompt | Model überarbeitet eigenen Plan |
| Konsensprüfung | debateOrchestrator.checkConsensus | Judge-Modell gibt JSON mit consensusScore zurück |
| Urteil | prompts/debatePrompts.judgePrompt | Richter gibt „# Endgültiger Implementierungsplan“ + Vertrauen zurück |
| Aufforderung zur Selbstdebatte | prompts/debatePrompts.selfDebatePrompt | Kette-von-Rekursiven-Gedanken- Schleife |
⚠️ Wichtig: Das Sage-Plan-Tool kann:
Typische Ressourcennutzung:
Legen Sie die folgenden Umgebungsvariablen fest:
OPENAI_API_KEY : Ihr OpenAI-API-Schlüssel (für O3-Modell)GEMINI_API_KEY : Ihr Google Gemini API-Schlüssel (für Gemini 2.5 Pro)Fügen Sie Ihrer MCP-Konfiguration nach dem Erstellen mit npm run build Folgendes hinzu:
Sie können auch an anderer Stelle festgelegte Umgebungsvariablen verwenden, beispielsweise in Ihrem Shell-Profil.
Um eine zweite Meinung zu etwas zu bekommen, fragen Sie einfach nach einer zweiten Meinung.
Um eine Codeüberprüfung zu erhalten, fordern Sie eine Codeüberprüfung oder eine Expertenüberprüfung an.
Beide profitieren von der Bereitstellung von Pfaden zu Dateien, die Sie in den Kontext aufnehmen möchten. Wenn diese jedoch weggelassen werden, leitet das Host-LLM wahrscheinlich ab, was aufgenommen werden soll.
Der Server stellt detaillierte Überwachungsinformationen über die MCP-Protokollierungsfunktion bereit. Diese Protokolle umfassen:
Protokolle werden über die notifications/message des MCP-Protokolls gesendet, um sicherzustellen, dass sie die JSON-RPC-Kommunikation nicht beeinträchtigen. MCP-Clients mit Protokollierungsunterstützung zeigen diese Protokolle entsprechend an.
Beispielprotokolleinträge:
Das Tool sage-opinion akzeptiert die folgenden Parameter:
prompt (Zeichenfolge, erforderlich): Die Eingabeaufforderung, die an das ausgewählte Modell gesendet werden sollpaths (Array von Zeichenfolgen, erforderlich): Liste der Dateipfade, die als Kontext einbezogen werden sollenBeispiel für einen MCP-Toolaufruf (mit JSON-RPC 2.0):
Das Tool sage-review akzeptiert die folgenden Parameter:
instruction (Zeichenfolge, erforderlich): Die spezifischen Änderungen oder Verbesserungen, die erforderlich sindpaths (Array von Zeichenfolgen, erforderlich): Liste der Dateipfade, die als Kontext einbezogen werden sollenBeispiel für einen MCP-Toolaufruf (mit JSON-RPC 2.0):
Die Antwort enthält SEARCH/REPLACE-Blöcke, die Sie zum Implementieren der vorgeschlagenen Änderungen verwenden können:
Das Tool sage-plan akzeptiert die folgenden Parameter:
prompt (Zeichenfolge, erforderlich): Beschreibung, wofür Sie einen Implementierungsplan benötigenpaths (Array von Zeichenfolgen, erforderlich): Liste der Dateipfade, die als Kontext einbezogen werden sollenBeispiel für einen MCP-Toolaufruf (mit JSON-RPC 2.0):
Die Antwort enthält einen detaillierten Implementierungsplan mit:
Dieser Plan profitiert von der kollektiven Intelligenz mehrerer KI-Modelle (oder einer gründlichen Selbstüberprüfung durch ein einzelnes Modell) und enthält in der Regel robustere, durchdachtere und detailliertere Empfehlungen als ein Single-Pass-Ansatz.
So testen Sie die Tools:
Hinweis : Die Ausführung des Sage-Plan-Tests kann 5–15 Minuten dauern, da er eine Debatte mehrerer Modelle orchestriert.
src/index.ts : Die Hauptimplementierung des MCP-Servers mit Tooldefinitionensrc/pack.ts : Tool zum Packen von Dateien in ein strukturiertes XML-Formatsrc/tokenCounter.ts : Dienstprogramme zum Zählen von Token in einer Eingabeaufforderungsrc/gemini.ts : Implementierung des Gemini-API-Clientssrc/openai.ts : OpenAI API-Clientimplementierung für das O3-Modellsrc/debateOrchestrator.ts : Multi-Modell-Debattenorchestrierung für Sage-Plansrc/prompts/debatePrompts.ts : Vorlagen für Debattenanregungen und -anweisungentest/run-test.js : Test für das Sage-Opinion-Tooltest/test-expert.js : Test für das Sage-Review-Tooltest/run-sage-plan.js : Test für das Sage-Plan-Tooltest/test-o3.js : Test für die ModellauswahllogikISC
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Ein MCP-Server, der Tools zum Einholen von Zweitmeinungen oder detaillierten Codeüberprüfungen von Gemini 2.5 Pro bereitstellt, indem er Dateiinhalte in Eingabeaufforderungen einbettet und so die Verarbeitung großer Codebasen mit umfangreichem Kontext ermöglicht.