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 代理的云原生“云”

它是什么 – Kody 是一个服务器端平台，存储 AI 代理的状态：内存片段、API 密钥、代码包和计划作业。它通过 模型上下文协议（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 – 一组紧凑的端点（search、execute 等），任何兼容 MCP 的 AI 主机都可以调用。
持久内存 – 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 的边缘数据库）
会话 / OAuth 存储：Cloudflare KV
有状态 MCP 对象：Cloudflare Durable Objects
测试：Playwright 用于端到端测试

典型工作流程

创建账户 – 通过 UI 或 API；OAuth 保护会话。
上传包 – 定义工具或代理自定义逻辑的代码。
添加记忆/凭据 – 存储在 Durable Objects / KV 中。
代理主机（例如 ChatGPT）调用 MCP – search 检索相关记忆，execute 运行包。
后台作业 – 可选 cron 作业在作业工作器中运行，可以更新记忆或触发外部服务。

入门（来自 README）

# 克隆仓库，安装依赖
npm install
# 启动本地开发服务器（Workers 和 D1 自动启动）
npm run dev

开发服务器会打印一个 URL，如 http://localhost:3742。对于基于相同约定的新项目，您也可以运行 npx create-epicflare。

文档亮点

架构 – docs/contributing/architecture/index.md 解释了四工作器拓扑。
项目意图 – docs/contributing/project-intent.md 阐明了范围（MCP 优先，而非通用工具目录）。
使用指南 – docs/use/index.md 展示了外部 MCP 主机应如何与 Kody 交互。
设置 – docs/contributing/getting-started.md 和 setup 文件夹涵盖环境变量、Cloudflare 绑定和本地验证。

许可证

Kody 根据 功能性源代码许可证 1.1（FSL-1.1-ALv2） 发布，允许免费使用、修改和再分发，但“竞争性使用”除外（复制 Kody 核心功能的商业产品）。版本发布两年后，它将重新许可为 Apache 2.0。

谁可能使用它？

LLM 驱动的代理，需要持久、可搜索的记忆存储。
构建 ChatGPT 插件或其他兼容 MCP 服务的开发者。
团队，希望为代理凭据、代码和计划作业提供一个共享、安全的地方。
研究人员，在不构建自己的边缘基础设施的情况下试验代理状态管理。

由 Epic Web 用 ❤️ 构建。