krusch-sequential-mcp

⚡ 왜 Krusch Sequential MCP인가요?

표준 sequential-thinking MCP는 사고 연쇄 추론을 위한 훌륭한 도구를 제공하지만, 다중 에이전트 환경에서 에이전트가 근거 없는 생각을 자신 있게 환각하여 컨텍스트 창을 오염시키는 "전화 게임" 문제로 고통받습니다.

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"]
    }
  }
}

🚀 빠른 시작 가이드

에이전트는 표준 매개변수(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