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: handoff-mcp

도구

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

배포

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

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 검증과 인증을 권장합니다.