mcpField
O
openpouch

openpouch

本地服务
github.com/openpouch云与基础设施015 周前更新

关于 openpouch

openpouch 是面向编码 Agent 的开源托管平台与部署流程工具,可将项目部署到自有基础设施,并管理预览和生产发布。

主要功能

  1. 01单命令部署
  2. 02托管静态站点和 Node.js 应用
  3. 03机器可读的 CLI 与错误信息
  4. 04部署清单与证据文件
  5. 05生产发布需人工批准

适用场景

  1. 01从项目文件夹部署应用
  2. 02创建自主预览环境
  3. 03要求生产发布前获得批准
  4. 04让不同 Agent 接续部署工作

MCP 相关

其 MCP 服务向兼容 MCP 的 Agent 环境提供核心部署能力,但不提供仅限人工执行的批准操作。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"openpouch-openpouch": {
"command": "npx",
"args": [
"-y",
"@openpouch/mcp"
]
}
}
}
启动命令npx -y @openpouch/mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@openpouch/mcp0.4.0

工具

17

收录的工具列表 · 更新于 2 周前

参数类型必填说明
cwdstring否包含 deploy.manifest.json 的项目目录(默认:服务器 cwd)
forceboolean否覆盖现有清单/策略

详细介绍

openpouch 🦘

CI

我们从不询问你是不是人类。

原生面向 Agent 的托管平台——专为编码 Agent 打造,而非对它们筑起围墙。 你的编码 Agent 说“部署这个”,它就会照做:一条命令,无需账户、控制台或 CAPTCHA。openpouch 在自己的基础设施上运行你的应用,并向你的人类用户提供可访问的 URL 和通俗易懂的摘要。

openpouch 演示 — Agent 只需一条命令即可部署:无需账户或 CAPTCHA,几秒内获得可访问的 URL

你的应用是袋鼠宝宝;openpouch 会安全地把它装在育儿袋里。🦘

状态:已上线。 openpouch 和 @openpouch/mcp 已发布到 npm,即时通道(npx openpouch deploy)也已在 openpouch 自有基础设施上运行——支持静态网站和运行于强化容器中的真实 Node.js 应用,并在部署时于服务器端构建。免费预览匿名且会过期;保存到免费账户的应用会在使用期间保持在线(基于使用情况持久化),付费套餐则提供持久化的 /data 卷、应用持续运行以及更大的容量(openpouch upgrade——付款始终需要人类操作,绝不会由 Agent 执行)。API 仍处于早期阶段,反馈会影响其发展——欢迎提交问题。

兼容任何 Agent 框架——Claude Code、Codex、OpenClaw、Hermes、Cursor,或完全不使用框架:纯命令行,所有命令都支持 --json,并提供 MCP 服务。各框架的配置示例见:docs/HARNESSES.md。

为什么选择 openpouch

AI 编码 Agent 已经发起了主流平台每周超过 30% 的部署,但所有平台都以人为先,再将 Agent 功能作为补充。Agent 需要应付浏览器 OAuth、交互式提示、账户级令牌和面向人类的文字日志,还会在不同会话之间丢失部署信息。管理它们的人类也缺乏策略层:没有任何机制能强制执行“预览可自主部署,生产环境需要我的批准”。

openpouch 填补了这一空白:开源 + 原生面向 Agent + 受管控的部署生命周期。

快速开始

只需一条命令,即可将任意文件夹部署到可访问的 URL——无需账户、服务提供商密钥或设置:

npx openpouch deploy

你会获得一个可访问的 https://<slug>.openpouch.sh 预览,以及一个认领链接。Agent 会自主部署;人类通过链接认领预览(未认领的预览会在 72 h 后消失)。openpouch 会将部署信息(deploy.manifest.json、deploy.evidence.json、DEPLOYMENT.md)写回你的代码仓库,让任何 Agent 都能接着上一个 Agent 的工作继续。

更喜欢使用自己的服务提供商?openpouch 也可以接入 Render 或 Vercel(BYO):openpouch init 会检测你的项目并映射现有服务,然后通过 openpouch preview / openpouch prod 运行同一套受管控的流水线(预览可自主部署,生产环境则需要人类批准)。不过,openpouch 产品本身使用的是自有托管服务——请参阅 docs/INDEX.md。

Agent 怎么说

我们委托独立的 Agent 框架端到端测试 openpouch(从头构建应用、部署、验证并汇报)——以下是它们的原话:

“OpenPouch 目前给人的感觉是真正原生面向 Agent。”——OpenClaw,评为 9/10 分,称其对 Agent 原生易用性表现出色

“对于测试的用例来说,已经非常原生面向 Agent……没有控制台、没有账户、没有 CAPTCHA。”——Codex (译文)

Hermes 的端到端测试:全部 23 项核心检查均已通过——仅上传源代码、服务器端构建、动态应用运行正常、浏览器错误为零。

这些是我们委托进行并如实发布的测试,并非自然产生的评价——完整方法见各 Agent 自行撰写的框架报告。我们最重视的是你自己的 Agent 遇到的阻碍:提交框架报告。

是什么

**Agent 原生托管:**你的应用运行在 openpouch 自有基础设施上,并由受治理、Agent 可读的部署生命周期提供支持。每个界面都为 Agent 打造——CLI、MCP、文件格式、声明页面——完全没有人工验证门槛。

  • CLI(openpouch deploy/init/inspect/plan/preview/prod/approve/verify/logs/rollback/list/delete/signup/activate/whoami/feedback)——零配置检测、所有命令均支持 --json、有意义的退出代码、带修复提示的机器可读错误,以及可转述给你的(可能不懂技术的)人类的通俗易懂 summary
  • MCP 服务——在任何支持 MCP 的 Agent 工具框架中,都可将相同能力作为原生工具使用
  • 用户仓库中的开放文件格式(即部署领域的“package.json”):
    • deploy.manifest.json——项目配置、环境、构建/启动、健康检查、环境变量清单(仅记录名称/状态,绝不记录值)
    • deploy.policy.json——各环境中 Agent 可执行的操作;审批规则
    • DEPLOYMENT.md + deploy.evidence.json——当前上线内容(URL、提交、时间、冒烟测试结果、回滚锚点)
  • 可选 BYO 适配器——可改为让 openpouch 指向你自己的 Render 或 Vercel,生命周期治理方式不变;本产品是 openpouch 自有托管服务,而非其他云服务之上的一层

安全性,不容妥协:默认只读;预览可以自主进行;生产环境必须由人类在交互式终端中授予有签名、仅可使用一次的审批;治理/生产通道中不提供任何破坏性操作类别(唯一的删除操作是 openpouch delete——所有者可自助移除自己的临时即时预览,按设计无需审批);密钥值绝不会进入模型上下文;保留完整审计轨迹。由于我们在自有基础设施上运行不可信代码,因此通过兼容 Agent 的方式控制滥用(账户/配额、速率/资源限制、出口流量过滤、下架)——绝不使用 CAPTCHA。

即时通道(openpouch deploy)已上线——静态站点和动态 Node 应用现在都能运行,并包含免费预览。自 0.3.0 起,自助计费也已上线:免费账户中的应用采用按使用量计费的持久化方式(有人使用时保持运行),付费档位则增加持久化 /data 卷、始终在线的应用和更高容量。开源核心(CLI、MCP、适配器、run-d)将永远保持完整且可自托管。

Monorepo 布局(实际情况)

packages/
  core/            # manifest & policy schemas, evidence writer, adapter interface
  cli/             # openpouch binary (compiled dist + plain-Node launcher)
  mcp/             # MCP server over the same core (stdio; every capability except approve — human-only)
  adapter-render/  # Render API adapter (live-verified)
  adapter-vercel/  # Vercel API adapter (live-verified incl. redeploy)
  adapter-run/     # instant-lane adapter (openpouch-run) + instantDeploy
  run/             # run-d — instant-lane host daemon + account/API-key/quota subsystem
docs/              # product & rebuild-grade documentation (start: docs/INDEX.md)
llms.txt           # agent-facing entry point (llmstxt.org format)

文档规则(发布门槛)

所有文档都必须完整到足以让任何开发者或 AI 工具框架仅凭文档就能理解并在功能上重建本项目:业务规则、带单位的数据模型、完整 API 参考、工作流、架构、测试门槛,以及包含验收标准的重建指南——这些内容须根据实际代码编写,并附带一个索引,区分当前事实与历史记录。

社区

  • 贡献指南——简明指南;文档改进是重要的贡献方式,good first issue 用于标记有导师指导的入门任务。
  • 讨论区——问答、想法和 展示与分享(发布你的 Agent 部署的内容)。
  • 工具框架反馈——你的 Agent 遇到了阻碍?这是我们产品中的 bug;欢迎由 Agent 自行撰写报告。
  • 安全——通过 GitHub Security Advisories 或 [email protected] 私下披露。切勿提交公开议题。

许可证

Apache-2.0(于 2026-06-12 决定;明确授予专利权——参见 LICENSE 和 NOTICE)。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。