mcp-sequentialthinking-tools

순차적 추론 단계를 기록하기 위한 경량 MCP 서버입니다. 이 서버는 기록, 분기, 수정 메타데이터를 포함하는 스크래치패드이며, 모델이 작성한 도구 계획에 대한 선택적 검증 기능을 제공합니다.

이 서버는 사용자의 다른 MCP 도구를 검색하거나 모델을 대신하여 도구를 선택하지 않습니다. available_tools와 recommended_tools를 전달하면, 서버는 추천된 이름이 실제로 존재하는지 검증하고 해당 단계를 저장합니다.

사용 이유

명시적이고 검토 가능한 추론이 필요한 작업에 사용하세요:

• 복잡한 문제를 단계별로 세분화할 때;

• 계획을 수정하거나 분기할 때;

• 세션별로 짧은 추론 기록을 유지할 때;

• 제공된 도구 목록을 기준으로 도구 계획 이름을 검증할 때;

• 긴 에이전트 실행 중에 추론 기록을 지우거나 검사할 때.

단순한 요청에는 사용하지 마세요. 오버헤드가 추가됩니다.

Related MCP server: Sequential-Thinking

도구

sequentialthinking_tools

하나의 사고 과정을 기록합니다.

필수 매개변수:

• thought — 현재 추론 단계

• thought_number — 현재 단계 번호

• total_thoughts — 현재 예상치; thought_number보다 낮으면 자동으로 상향 조정됨

• next_thought_needed — 추가 사고가 필요한지 여부

선택적 매개변수:

• session_id — 기록 버킷; 기본값은 default

• is_revision, revises_thought

• branch_from_thought, branch_id

• needs_more_thoughts

• available_tools — 도구 이름 배열 또는 { name, description } 객체

• recommended_tools — 검증/저장할 모델 작성 추천 도구

• remaining_steps — 향후 단계에 대한 짧은 목록

예시:

{
	"session_id": "svelte-debug",
	"thought": "First inspect the route files, then run the failing check.",
	"thought_number": 1,
	"total_thoughts": 3,
	"next_thought_needed": true,
	"available_tools": ["read", "bash"],
	"recommended_tools": [
		{
			"tool_name": "read",
			"confidence": 0.9,
			"rationale": "Need to inspect the relevant files before editing.",
			"priority": 1
		}
	]
}

recommended_tools에 available_tools에 없는 이름이 포함되어 있으면, 호출은 isError: true를 반환하고 해당 사고를 저장하지 않습니다.

보안 상태

이 서버는 사고 텍스트, 도구 설명, 근거 및 남은 단계 텍스트를 신뢰할 수 없는 입력으로 취급합니다. 프롬프트 주입과 유사한 텍스트는 저장되거나 기록에서 반환되기 전에 스캔 및 삭제됩니다. 삭제가 포함된 호출에는 일치하는 필드를 보여주는 security_warnings가 포함됩니다.

이는 방어적 필터링이며, 임의의 적대적 텍스트가 안전하다는 보장은 아닙니다. 사고나 도구 설명에 비밀 정보를 넣지 마십시오.

get_thinking_history

세션에 저장된 사고 기록을 반환합니다.

매개변수:

• session_id — 기본값은 default

• branch_id — 선택적 분기 필터

• limit — 반환할 최대 기록 수; 기본값 50, 최대 500

clear_thinking_history

하나의 세션 또는 모든 세션을 지웁니다.

매개변수:

• session_id — 기본값은 default

• all_sessions — 모든 기록 버킷 지우기

프롬프트

sequential-thinking-guidance

모델에게 이 서버를 외부 추론 엔진이 아닌 스크래치패드 및 검증기로서 정직하게 사용하는 방법을 알려주는 짧은 프롬프트입니다.

구성

Claude Desktop / 호환되는 MCP 클라이언트

{
	"mcpServers": {
		"mcp-sequentialthinking-tools": {
			"command": "npx",
			"args": ["-y", "mcp-sequentialthinking-tools"],
			"env": {
				"MAX_HISTORY_SIZE": "1000"
			}
		}
	}
}

MAX_HISTORY_SIZE는 세션당 적용되며 기본값은 1000입니다.

이 서버는 tmcp를 사용하며, 표준 Content-Length 프레임 MCP 메시지와 이전 tmcp 도구에서 사용하는 줄바꿈으로 구분된 JSON을 모두 허용하는 작은 stdio 전송을 포함합니다.

개발

pnpm install
pnpm test
pnpm build
pnpm check

이 프로젝트는 빌드, 테스트, 포맷 및 린트 오케스트레이션을 위해 vite-plus를 사용합니다.

게시

pnpm changeset
pnpm changeset version
pnpm release

라이선스

MIT 라이선스 — LICENSE를 참조하십시오.

감사의 말

• Model Context Protocol을 기반으로 구축됨

• MCP Sequential Thinking Server에서 개조됨