cortex-docs/cortex

何を解決するか

CortexはAPI仕様とMarkdownから、一貫した開発者ツールを統合的に生成します。API仕様からクライアントSDK、インタラクティブなドキュメント、AIエージェント用のインターフェースを個別に管理する必要がなくなります。

仕組み

Cortexは1つのプロジェクト設定ファイル（cortex.config.yml）を使用して、OpenAPI、AsyncAPI、GraphQL、gRPC（Protocol Buffers）、OpenRPCなどのAPI仕様とMarkdownファイルを読み込みます。これらの情報から自動的に以下を生成します：

• 型付きSDK：TypeScript、Python、Go、Rustなど11言語に対応するクライアントライブラリ。
• インタラクティブなドキュメント：APIリファレンスやガイドを含む静的HTMLサイト。
• MCPサーバー：AIエージェントに型付きツール、埋め込み仕様、プロジェクトコンテキストを提供するModel Context Protocolサーバー。

対象ユーザー

人間の開発者（SDKやドキュメント経由）とAIエージェント（MCPサーバー経由）の両方にAPIを配布する必要がある開発者やAPI提供者向けです。すべての出力は1つのソースから同期されます。

特徴

• マルチプロトコル対応：REST、WebSockets、GraphQL、gRPC、JSON-RPCをサポート。
• 統合生成：1つのコマンドでSDK、ドキュメント、MCPサーバーを生成。
• エージェント対応：AIエージェントがAPIツールとドキュメントにアクセスできるMCPサーバーを自動生成。
• 広範な言語サポート：C++、C#からRuby、PHPまで、多様なSDK対応言語を提供。
• カスタマイズ可能：Etaテンプレートの上書きにより出力のカスタマイズが可能。