OODS Foundry

OODS Foundry

OODS Foundry 是一种面向对象的设计系统，可扩展你已有的设计系统。你的 AI 助手通过 MCP 驱动它。按对象及其上下文描述屏幕，例如订阅详情视图。OODS Foundry 会组合受治理的组件和设计令牌，生成 React 或 Vue 代码，并根据你的数据渲染图表。

当你的产品包含重复出现的对象和工作流、屏幕需要在不同框架和主题间共享规则，或你希望生成的 UI 遵循现有设计系统时，可以使用它。你可以定义自己的对象、特征、品牌和组件映射。

生成的代码会附带一份回执，列出已执行的静态检查以及仍需完成的工作。图表认证会衡量渲染规格的准确性、无障碍等效性、对比度和确定性。它不会认证整个应用程序。

可选的 a11y_scan 工具会检查每个已构建品牌和主题中，组件样式表声明的文本与图标对比度配对项。给定屏幕架构后，它还会渲染屏幕并检查其文档无障碍规则；范围和阈值请参阅工具参考。

试用五分钟演示

将 Cal.com 的真实架构转换为你自己的 shadcn 组件中的 React 和 Vue 屏幕。按照提示操作，查看提议内容并确认，然后在浅色或深色模式下打开列表、详情、表单和时间线。

安装

在 macOS 或 Linux 上使用 Node.js 22.0.0 或更高版本。要在 Claude Code 中运行本地服务：

claude mcp add oods-foundry -- npx -y @oods/foundry
claude mcp get oods-foundry

要使用包含服务和引导式技能的 Claude Code 插件：

claude plugin marketplace add https://github.com/kneelinghorse/oods-foundry-claude-plugin.git
claude plugin install oods-foundry@oods-foundry

重启 Claude Code 并调用 /oods-foundry:oods-foundry。让你的助手调用 health_check，然后在 detail 上下文中组合一个 Subscription。软件包指南包含 Claude Desktop 和 Cursor 配置，并说明本地文件和网络访问。操作指南将带你从对象定义开始，生成一个应用程序。

要连接托管服务，请在兼容的 MCP 客户端中使用流式 HTTP 端点 https://oods-foundry.com/mcp。网站介绍了可用工具。本地安装提供完整的创作工作流；托管服务有自己的工具接口和发布计划。

Docker stdio 服务

构建提供的 Dockerfile，然后为 MCP 客户端保持 stdin 打开：

docker build -t oods-foundry .
docker run --rm -i -v oods-data:/data oods-foundry

镜像以非特权 node 用户身份运行。卷会保留已注册的对象和导入草稿。架构文件需单独挂载，例如 -v "$PWD/schemas:/schemas:ro"，并将容器路径传给 object_import。运行中应用的预览会绑定到容器内的 loopback；若要在主机上预览浏览器，请使用本地 npm 安装。

源代码和发布版本

此仓库镜像了每个发布版本，每个版本对应一个提交。源代码包含设计系统、React 和 Vue 库、MCP 服务、桥接程序、适配器和打包脚本。工具参考介绍了各项调用及其契约。

要从此快照安装工作区：

corepack pnpm install --frozen-lockfile

从源代码构建和测试介绍了软件包构建、运行时组装和公开测试命令。

欢迎通过 Issues提交 Bug 报告和反馈。此发布镜像不接受拉取请求；此类请求会被关闭。请参阅 CONTRIBUTING 和 SECURITY。

许可证

OODS Foundry 根据 Apache-2.0 授权；版权所有者、第三方声明和许可证常见问题请参阅 NOTICE。

发布快照之前的提交在 package.json 中声明了 MIT 许可证，且没有 LICENSE 文件。