cortex-docs/cortex

해결하는 문제

Cortex는 API에 대한 일관된 개발자 도구를 유지 관리하는 과정을 단순화합니다. API 사양에서 클라이언트 SDK, 인터랙티브 문서, AI 대응 인터페이스를 별도로 분리된 도구 체인으로 생성할 필요가 없습니다.

작동 방식

Cortex는 하나의 프로젝트 설정 파일(cortex.config.yml)을 사용하여 OpenAPI, AsyncAPI, GraphQL, gRPC(Protocol Buffers), OpenRPC 등의 API 사양과 마크다운 파일을 입력받습니다. 이들 소스에서 자동으로 다음을 생성합니다:

• 타입 지정된 SDK: TypeScript, Python, Go, Rust 등 11개 언어 지원하는 클라이언트 라이브러리.
• 인터랙티브 문서: API 참조 및 가이드를 포함한 정적 HTML 사이트.
• MCP 서버: AI 에이전트에게 타입 지정된 도구, 내장된 사양, 프로젝트 컨텍스트를 제공하는 Model Context Protocol 서버.

대상 사용자

인간 개발자(SDK 및 문서를 통해)와 AI 에이전트(모델 컨텍스트 프로토콜 서버를 통해) 모두에게 API를 배포해야 하며, 세 가지 모두를 하나의 진실의 원천에서 동기화하고 싶은 개발자 및 API 제공자에게 적합합니다.

주요 특징

• 다중 프로토콜 지원: REST, WebSockets, GraphQL, gRPC, JSON-RPC를 지원합니다.
• 통합 생성: 한 명령어로 SDK, 문서, MCP 서버를 생성합니다.
• 에이전트 준비 완료: AI 에이전트가 API 도구와 문서에 접근할 수 있도록 자동으로 MCP 서버를 생성합니다.
• 광범위한 언어 지원: C++ 및 C#에서부터 Ruby, PHP까지 SDK 생성에 지원하는 다양한 언어를 제공합니다.
• 사용자 정의 가능: Eta 템플릿 오버라이드를 통해 출력을 사용자 정의할 수 있습니다.