krusch-sequential-mcp

⚡ Почему Krusch Sequential MCP?

Стандартный MCP-инструмент sequential-thinking отлично подходит для пошагового рассуждения, но страдает от проблемы «испорченного телефона» в многоагентных средах, где агенты могут уверенно галлюцинировать необоснованные мысли, отравляющие контекстное окно.

krusch-sequential-mcp решает эту проблему, внедряя семантический контроль правдоподобия (Semantic Plausibility Gating) наряду с высоконадежным уровнем сохранения данных в 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"]
    }
  }
}

🚀 Руководство по быстрому старту

Агенты могут вызывать инструмент sequentialthinking со стандартными параметрами (thought, thoughtNumber, totalThoughts, nextThoughtNeeded и т. д.).

Чтобы задействовать шлюз правдоподобия, включите параметр 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 © 2026 kruschdev