EEVEE MCP

EEVEE 是一个面向人类和浏览器代理的持久工作台。代理使用页面的 WebMCP 工具来创建和检查小程序。EEVEE 负责那些必须保持可预测的部分：类型化输入、不可变版本、评估、审批、执行、状态和更正。

第一个可用的垂直切片是一个自包含的 Web 小程序。它覆盖了完整的生命周期：

1. 代理创建一个小程序和一个不可变版本。

2. EEVEE 验证输入表单并评估 HTML。

3. 人工审核并发布通过的版本。

4. 小程序在具有持久键值状态的沙箱中运行。

5. 人工针对一次运行记录更正，而不更改实时版本。

文档、电子表格、演示文稿、PDF、工作流和媒体配方已经存在于持久小程序模型中。它们的执行器和质量套件是下一个实现里程碑。质量契约记录了 EEVEE 在认定每种媒介可用之前必须提供的证明。

WebMCP 工具

EEVEE 使用 document.modelContext.registerTool 注册工具。当此页面打开时，兼容的浏览器代理可以使用这些工具。

发布操作保留在 EEVEE 界面中。没有任何 WebMCP 工具可以批准自己的输出。

Related MCP server: Adaptive Agent Harness

本地运行

要求：Node.js 24、npm 10 或更高版本，以及 Docker。

cp .env.example .env.local
docker compose up -d
npm ci
npm run db:migrate
npm run dev

打开 http://localhost:3000。要在 Chrome 149 或更高版本中暴露这些工具，请启用 chrome://flags/#enable-webmcp-testing 并重新启动 Chrome。然后兼容的代理就可以从打开的页面中发现这些工具。

首次运行时，请向代理提问：

Create a self-contained project task register in EEVEE. Give it a required project-name input, persistent tasks, keyboard-friendly controls, responsive layout, and no network dependencies. Show me the evaluated version for approval, then run it with the project name "WebMCP launch".

验证

npm run lint
npm run typecheck
DATABASE_URL=postgres://eevee:eevee@localhost:55433/eevee_mcp npm test
npm run build

集成套件使用 PostgreSQL。当缺少 DATABASE_URL 时，单元测试仍然运行；在这种情况下，数据库生命周期套件会跳过。

设计

规范路径是：

browser agent -> WebMCP tools -> typed API -> applet service -> PostgreSQL
                                      |              |
                                      |              +-> immutable versions, runs, state, corrections
                                      +-> generated form and human approval

有关信任边界，请参阅 architecture.md；有关产品语言，请参阅 CONTEXT.md；有关干净仓库记录，请参阅 provenance.md。

许可证

Apache-2.0。用于展示字体的 Avara Variable 仍遵循 SIL Open Font License 1.1。请参阅 NOTICE 和 随附的字体许可证。