Name: krusch-sequential-mcp
Author: kruschdev

⚡ Warum Krusch Sequential MCP?

Das standardmäßige sequential-thinking MCP bietet ein großartiges Werkzeug für Chain-of-Thought-Überlegungen, leidet jedoch unter dem „Stille-Post“-Problem in Multi-Agenten-Umgebungen, bei denen Agenten selbstbewusst unbegründete Gedanken halluzinieren können, die das Kontextfenster vergiften.

krusch-sequential-mcp löst dies durch die Einführung eines semantischen Plausibilitäts-Gatings zusammen mit einer hochzuverlässigen DBOS PostgreSQL-Persistenzschicht.

Hauptmerkmale

🧠 Semantisches Plausibilitäts-Gating: Erkennt und verwirft autonom abgedriftete oder halluzinierte Gedanken über einen Edge-Modell-Evaluator.
💾 DBOS PostgreSQL-Persistenz: Speichert jeden Gedanken, Zweig und jede Revision synchron in einer dbos_thoughts-Tabelle und erstellt so einen prüfbaren DAG der Argumentation.
🛑 Deterministische Zustandszuverlässigkeit: Stoppt die Ausführung vergifteter Gedanken und zwingt Agenten dazu, ihren Argumentationspfad neu zu bewerten.
🔌 Drop-In-Ersatz: Vollständig kompatibel mit der standardmäßigen sequential-thinking-Schnittstelle bei gleichzeitiger Unterstützung des neuen groundingContext-Parameters.
📦 Keine externen Abhängigkeiten: Der Plausibilitäts-Evaluator ist vollständig in sich geschlossen – kein externes Toolkit erforderlich.

🧠 Architektur: Semantisches Plausibilitäts-Gate

Wenn ein Agent einen Gedanken vorschlägt, prüft der interne Evaluator diesen anhand des bereitgestellten groundingContext.

graph TD;
    A[Agent Thought Proposed] --> B{Grounding Context Provided?};
    B -- No --> C[Accept & Persist to DBOS];
    B -- Yes --> D[Edge Model Evaluator];
    D -- Plausible --> C;
    D -- Hallucinated/Drifted --> E[Reject Thought];
    E --> F[Return Soft Error to Agent];
    F --> G[Agent Re-evaluates];

📦 Installation

npm install -g krusch-sequential-mcp

Oder konfigurieren Sie es in Ihrer MCP-Einstellungsdatei (z. B. claude_desktop_config.json oder .cursor/mcp.json):

{
  "mcpServers": {
    "krusch-sequential-mcp": {
      "command": "npx",
      "args": ["-y", "krusch-sequential-mcp"]
    }
  }
}

🚀 Kurzanleitung

Agenten können das sequentialthinking-Tool mit den Standardparametern (thought, thoughtNumber, totalThoughts, nextThoughtNeeded usw.) aufrufen.

Um das Plausibilitäts-Gate zu aktivieren, fügen Sie den groundingContext-Parameter in Ihren Tool-Aufruf ein:

{
  "thought": "Since the user is asking about the database schema, I will assume it uses MongoDB and write a query for it.",
  "thoughtNumber": 1,
  "totalThoughts": 3,
  "nextThoughtNeeded": true,
  "groundingContext": "The current codebase exclusively uses DBOS PostgreSQL for persistence. No NoSQL databases are present."
}

Da der Gedanke im Widerspruch zum groundingContext steht, wird der Evaluator ihn autonom ablehnen und einen Fehler an den Agenten zurückgeben, damit dieser seinen Ansatz überdenkt.

⚙️ Umgebungsvariablen

Variable	Erforderlich	Standard	Beschreibung
`DATABASE_URL`	Nein	(keine — Persistenz deaktiviert)	PostgreSQL-Verbindungszeichenfolge (z. B. `postgres://user:pass@localhost:5432/mydb`). Wenn nicht festgelegt, läuft der Server im reinen Speichermodus.
`OLLAMA_URL`	Nein	`http://localhost:11434`	Basis-URL zum Ollama-Dienst für Plausibilitätsprüfungen.
`PLAUSIBILITY_MODEL`	Nein	`qwen2.5-coder:1.5b`	Ollama-Modell, das für das Plausibilitäts-Screening verwendet wird. Sollte ein kleines, schnelles Modell sein.

Kopieren Sie .env.example für einen schnellen Start:

cp .env.example .env

🤝 Mitwirken

Wir freuen uns über Beiträge! Bitte stellen Sie sicher, dass Ihre Tests bestehen und die Formatierungsstandards des Projekts eingehalten werden. Führen Sie Tests über npm run build und npm start (oder node build/index.js) aus.