프로젝트 소개

이 저장소는 Katana Manufacturing ERP API를 위한 다국어 클라이언트 생태계를 제공하며, Python 및 TypeScript 클라이언트와 알파 버전의 Model Context Protocol(MCP) 서버를 포함합니다. 모든 클라이언트는 OpenAPI 3.1.0 사양에서 생성되었으며, 자동 재시도, 속도 제한 처리, 스마트 페이지네이션 기능을 갖추고 있습니다. Python 클라이언트는 동기 및 비동기 작업을 모두 지원하며 완전한 Pydantic 타입 안전성을 제공하고, TypeScript 클라이언트는 비동기 전용으로 완전한 타입 안전성과 브라우저 지원을 제공합니다. MCP 서버는 선별된 고급 도구(검색, 수정, 이행, 검증)를 래핑하며 쓰기 작업에 대한 미리보기/적용 쌍을 포함하여 Claude 및 Cursor와 같은 AI 어시스턴트와의 통합을 가능하게 합니다. 구성은 환경 변수, .env 파일 또는 직접 매개변수를 통해 유연하게 설정할 수 있습니다. 프로젝트는 공유 문서, 아키텍처 결정 기록, uv를 사용한 통합 빌드 시스템을 갖춘 모노레포로 구성되어 있습니다. 개발에는 사전 커밋 훅, 자동 릴리스를 위한 컨벤셔널 커밋, 포괄적인 테스트가 포함됩니다.