Claude Code를 REST API로 감싸기: 세션, 스트리밍, MCP

121
AI 요약

이 글은 AI가 원문을 분석하여 핵심 내용을 요약한 것입니다.

이 게시물은 Claude Code를 REST API로 감싸는 과정에서 세션 관리, 스트리밍 분리, MCP 도구 브릿지에 관한 설계와 구현 이슈 공유

핵심 의사결정

  • 세션 기반 메모리: API로 받은 CoreMessage[]를 Claude Code의 JSONL 세션으로 변환해 로컬에 저장하고 SDK의 resume 옵션으로 복원
  • 스트리밍 처리: SDK의 혼합 이벤트를 파싱해 text, reasoning, completion 등 별도 AsyncIterable 스트림으로 분리해 클라이언트가 필요한 스트림만 구독 가능
  • MCP 도구 브릿지: 기존 AI SDK 도구들을 createSdkMcpServer로 MCP 서버로 변환해 Claude Code의 도구 호출 규칙(mcp__{server}__{tool}) 적용
운영 고려사항: 위험 도구 차단 설정, Docker 환경에서의 CLI 설치 및 경로 처리, 통합 테스트로 세션/도구/스트리밍 엣지케이스 검증

연관 게시글