krusch-sequential-mcp

⚡ なぜ Krusch Sequential MCP なのか？

標準の sequential-thinking MCP は思考連鎖推論のための優れたツールですが、マルチエージェント環境では「伝言ゲーム」の問題に悩まされます。エージェントが根拠のない思考を自信満々にハルシネーション（幻覚）し、コンテキストウィンドウを汚染してしまうのです。

krusch-sequential-mcp は、セマンティック妥当性ゲートと、非常に信頼性の高い DBOS PostgreSQL永続化レイヤーを導入することで、この問題を解決します。

主な機能

• 🧠 セマンティック妥当性ゲート: エッジモデル評価器を通じて、逸脱した思考やハルシネーションを自律的に拒否します。

• 💾 DBOS PostgreSQL永続化: すべての思考、ブランチ、リビジョンを dbos_thoughts テーブルに同期的に保存し、監査可能な推論のDAG（有向非巡回グラフ）を作成します。

• 🛑 決定論的な状態の信頼性: 汚染された思考の実行を停止し、エージェントに推論パスの再評価を強制します。

• 🔌 ドロップイン置換: 標準の sequential-thinking インターフェースと完全な互換性を持ちつつ、新しい groundingContext パラメータをサポートします。

• 📦 外部依存関係ゼロ: 妥当性評価器は完全に自己完結しており、外部ツールキットは不要です。

🧠 アーキテクチャ: セマンティック妥当性ゲート

エージェントが思考を提案すると、内部評価器が提供された 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];

📦 インストール

npm install -g krusch-sequential-mcp

または、MCP設定ファイル（例: claude_desktop_config.json や .cursor/mcp.json）で設定します：

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

🚀 クイックスタートガイド

エージェントは、標準パラメータ（thought、thoughtNumber、totalThoughts、nextThoughtNeeded など）を使用して sequentialthinking ツールを呼び出すことができます。

妥当性ゲートを有効にするには、ツール呼び出しに groundingContext パラメータを含めてください：

{
  "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."
}

思考が groundingContext と矛盾するため、評価器は自律的にそれを拒否し、エージェントにアプローチの再考を促すエラーを返します。

⚙️ 環境変数

クイックスタートのために .env.example をコピーしてください：

cp .env.example .env

🤝 コントリビューション

コントリビューションを歓迎します！テストがパスすること、およびプロジェクトのフォーマット基準に従っていることを確認してください。 テストは npm run build および npm start（または node build/index.js）で実行できます。

📄 ライセンス

MIT License © 2026 kruschdev