kody-hq/kody

🐨 The cloud for your team's agents. Save your agent memory, credentials, code, and automations, portable across every agent with Kody.

Kody – AI 에이전트를 위한 Cloud‑네이티브 “클라우드”

이것이 무엇인가 – Kody는 AI 에이전트의 상태를 저장하는 서버‑사이드 플랫폼입니다: 메모리 조각, API 키, 코드 패키지, 예약된 작업. 이 데이터는 Model Context Protocol (MCP) 을 통해 노출되어, MCP‑호환 호스트(예: ChatGPT 플러그인)가 에이전트의 컨텍스트를 읽거나 쓸 수 있습니다. 전체 시스템은 Cloudflare Workers에서 실행되어 전 세계적으로 분산되고, 저지연, 저비용 운영이 가능합니다.

왜 중요한가 – 현대 LLM‑기반 에이전트는 호출 간에 유지되는 영구 정보(과거 대화, 도구 정의, 자격 증명)를 저장할 장소가 필요합니다. Kody는 이러한 지속성을 일급 서비스로 제공하며, 내장 OAuth 보호와 인간이 저장된 데이터를 검사하거나 편집할 수 있는 Remix‑기반 UI를 갖추고 있습니다.

핵심 구성 요소

구성 요소	역할
kody‑worker (origin)	Remix UI를 제공하고, OAuth를 처리하며, MCP HTTP 요청을 라우팅하는 진입점.
kody‑platform‑worker	Cloudflare Durable Objects를 사용하여 MCP 메일박스, 계량, 세션 상태를 구현.
kody‑runtime‑worker	`execute` 흐름을 통해 사용자가 업로드한 패키지(코드, 도구)를 주문형 실행.
kody‑jobs‑worker	Cron‑스타일 작업 스케줄러; 백그라운드 작업을 실행하고 JobsHost를 통해 보고.
mock‑servers	Workers용 로컬 테스트 더블로, 빠른 CI/E2E 실행을 가능하게 함.

주요 기능

MCP‑우선 API – MCP‑호환 AI 호스트가 호출할 수 있는 간결한 엔드포인트 집합(search, execute 등).
영구 메모리 – Durable Objects가 에이전트가 쿼리하거나 업데이트할 수 있는 계정별 “메모리”를 저장.
안전한 자격 증명 – OAuth‑보호 엔드포인트 및 Cloudflare KV가 API 키/비밀 토큰을 저장.
패키지 런타임 – 사용자가 런타임 워커가 안전하게 호출할 수 있는 코드 패키지를 업로드 가능.
작업 스케줄링 – 반복 작업(예: 데이터 새로고침, 정리)을 위한 내장 cron 관리자.
팀 격리 – 각 계정(개인 또는 조직)은 패키지, 작업, 자격 증명, 메모리에 대해 자체 격리된 네임스페이스를 가짐.
로컬 개발 경험 – wrangler가 localhost:3742에서 전체 Workers + D1(SQLite‑호환) 스택을 시작.

기술 스택 (README에 명시된 대로)

런타임: Cloudflare Workers (서버리스 엣지 플랫폼)
UI: Remix 3 (베타) Vite와 함께 번들
패키지 관리자: npm (Nx 모노레포 워크스페이스)
데이터베이스: Cloudflare D1 (SQL‑유사 엣지 DB)
세션 / OAuth 저장소: Cloudflare KV
상태 저장 MCP 객체: Cloudflare Durable Objects
테스트: Playwright for end‑to‑end tests

일반적인 워크플로우

계정 생성 – UI 또는 API를 통해; OAuth가 세션을 보호.
패키지 업로드 – 에이전트의 도구나 사용자 정의 로직을 정의하는 코드.
메모리/자격 증명 추가 – Durable Objects / KV에 저장.
에이전트 호스트(예: ChatGPT)가 MCP 호출 – search로 관련 메모리 검색, execute로 패키지 실행.
백그라운드 작업 – 선택적 cron 작업이 jobs worker에서 실행되어 메모리를 업데이트하거나 외부 서비스를 트리거할 수 있음.

시작하기 (README에서)

# 저장소 클론, 의존성 설치
npm install
# 로컬 개발 서버 시작 (Workers + D1 자동 시작)
npm run dev

개발 서버는 http://localhost:3742와 같은 URL을 출력합니다. 동일한 규칙을 기반으로 한 새 프로젝트는 npx create‑epicflare를 실행할 수도 있습니다.

문서 하이라이트

아키텍처 – docs/contributing/architecture/index.md는 4‑worker 토폴로지를 설명.
프로젝트 의도 – docs/contributing/project-intent.md는 범위를 명확히 함(MCP‑우선, 일반 도구 카탈로그가 아님).
사용 가이드 – docs/use/index.md는 외부 MCP 호스트가 Kody와 상호 작용해야 하는 방법을 보여줌.
설정 – docs/contributing/getting-started.md 및 setup 폴더는 환경 변수, Cloudflare 바인딩, 로컬 검증을 다룹니다.

라이선스

Kody는 Functional Source License 1.1 (FSL‑1.1‑ALv2) 하에 출시되며, “경쟁적 사용”(Kody의 핵심 기능을 복제하는 상업 제품)을 제외한 무료 사용, 수정, 재배포를 허용합니다. 버전 출시 2년 후 Apache 2.0으로 재라이선스됩니다.

누가 사용할 수 있을까?

LLM‑기반 에이전트 – 영구적이고 검색 가능한 메모리 저장소가 필요한 경우.
ChatGPT 플러그인 또는 기타 MCP‑호환 서비스를 구축하는 개발자.
에이전트 자격 증명, 코드, 예약 작업을 위한 공유되고 안전한 장소를 원하는 팀.
자체 엣지 인프라를 구축하지 않고 에이전트 상태 관리를 실험하는 연구자.

❤️ Epic Web이(가) 제작.