kody

Kody 是一个个人助理平台，旨在成为 AI 智能体记忆、密钥、代码和自动化的归宿，目标是保持可在兼容的 MCP 主机之间移植。它构建于 Cloudflare Workers 和 Model Context Protocol 之上，并附带一个 Remix UI、基于 Worker 的请求路由、包运行时管道以及受 OAuth 保护的 MCP 端点。 架构与范围 该项目倾向于紧凑的 MCP 接口，采用搜索和 Code Mode 执行流程，而非庞大的静态工具目录。它被描述为一个多用户个人助理：每位登录用户都会获得一个完全隔离的助理，涵盖包、任务、密钥、记忆及相关状态。测试和夹具可能会预置确定性的本地账户，但运行时没有任何账户享有特权。README 指出，该项目是一个 Fair Source 个人助理平台，而非通用智能体框架，并且 ChatGPT 可能是主要的目标宿主，同时尽可能让服务器可从其他 MCP 主机使用。 仓库布局 该仓库是一个 Nx monorepo。共享模块位于 packages/shared，源应用 worker 位于 packages/worker，同级 worker 位于 packages/platform-worker、packages/runtime-worker 和 packages/jobs-worker，另有位于 packages/mock-servers 下的模拟 Worker。生产拓扑记录在 docs/contributing/architecture 中。所描述的请求流程为：首先处理 OAuth 请求，然后处理 MCP 请求，再处理静态资源；非资源请求会落到服务器处理器和路由器，客户端资源被打包到 packages/worker/public 并通过 ASSETS 绑定提供服务。 技术栈 运行时：Cloudflare Workers。UI 框架：Remix 3（beta）。包管理器：npm。工作区：Nx 加 npm workspaces。数据库：Cloudflare D1。会话/OAuth：Cloudflare KV。MCP 状态：kody-platform 上的 Durable Objects。E2E 测试：Playwright。打包工具：Vite。 快速开始 使用 npm install 安装依赖，并使用 npm run dev 启动开发服务器。开发服务器默认运行在 localhost:3742，CLI 会选择下一个空闲端口并打印解析后的 URL；Wrangler 会自动处理本地 Cloudflare Workers 运行时和 D1 数据库。若要从 epicflare 模板搭建新项目，README 指向 npx create-epicflare。更多设置路径和预期见 docs/contributing/getting-started.md，贡献者和智能体请参阅 AGENTS.md 获取仓库特定指南。项目意图记录在 docs/contributing/project-intent.md 中。 文档与贡献 README 链接的文档涵盖设置、环境变量、可选的 Cloudflare 集成、项目意图、开发和扩展 Kody、通过 MCP 使用 Kody，以及本地开发和验证。外部拉取请求需要签署入站贡献者许可协议；通过 Kody 发布的公共包不使用该 CLA。该仓库采用 Functional Source License 1.1 许可，未来将转为 Apache 2.0 许可，允许出于除竞争性使用之外的任何目的进行使用、复制、修改、衍生作品、公开表演、展示和再分发，每个版本将在其发布两周年时以 Apache 2.0 提供。