mcp-think

Cloudflare Workers용으로 구축된 구조화된 순차적 사고를 위한 원격 MCP 서버입니다.

아키텍처

• Cloudflare Worker는 Streamable HTTP를 통해 /mcp를 노출합니다.

• MCP SDK v2가 도구를 정의합니다.

• Durable Objects + SQLite가 각 시퀀스를 영속화합니다.

• 시퀀스는 명시적인 sequenceId로 주소가 지정되며, MCP 프로토콜 세션은 애플리케이션 상태를 전달하지 않습니다.

이 설계는 현재 Cloudflare 지침을 따릅니다: 새 MCP 서버는 v2/무상태(stateless) 핸들러를 사용하고, 다단계 워크플로우의 애플리케이션 상태는 명시적인 Durable Object 경계 뒤에 위치합니다. McpAgent는 더 이상 사용되지 않으며 의도적으로 여기서 사용되지 않습니다.

Related MCP server: Sequential-Thinking

도구

start_sequence

시퀀스를 생성하고 sequenceId를 반환합니다.

add_step

구조화된 단계를 추가합니다. 요약, 가정, 증거, 가설 또는 결정에 사용하세요. 이 서버는 숨겨진 사고 과정(chain-of-thought)을 노출하거나 저장하도록 설계되지 않았습니다.

revise_step

원본 레코드를 보존하면서 이전 단계의 새 개정판을 생성합니다.

get_sequence

시퀀스 메타데이터와 저장된 모든 단계를 반환합니다.

finish_sequence

최종 결론을 저장하고 시퀀스를 완료된 것으로 표시합니다.

reset_sequence

저장된 시퀀스 데이터를 삭제합니다.

로컬 개발

npm install
npm run typecheck
npm run dev

로컬 MCP 엔드포인트는 다음과 같습니다:

http://localhost:8787/mcp

헬스 체크:

http://localhost:8787/health

배포

Wrangler를 Cloudflare 계정으로 인증하고 다음을 실행하세요:

npm run deploy

Cloudflare는 wrangler.jsonc의 마이그레이션에서 SQLite 기반 Durable Object를 프로비저닝합니다.

예시 흐름

start_sequence(goal)
      ↓
sequenceId
      ↓
add_step(sequenceId, ...)
      ↓
add_step(sequenceId, ...)
      ↓
revise_step(sequenceId, stepId, ...)
      ↓
get_sequence(sequenceId)
      ↓
finish_sequence(sequenceId, conclusion)

보안 로드맵

MVP는 의도적으로 인증이 없습니다. 엔드포인트를 공개적으로 노출하기 전에 OAuth 또는 다른 인증 계층을 추가하고 시퀀스 소유권을 인증된 주체에 바인딩하세요. Cloudflare의 MCP 지침은 또한 CORS를 인증 메커니즘으로 취급하는 대신 명시적인 Host/Origin 검증과 인증을 권장합니다.