VibeCart

面向AI构建的应用和AI代理的商业基础设施。

VibeCart让商家可以保留其现有应用和Stripe账户，同时添加一个可检查的小型商业层，供AI代理发现和使用。支付直接结算到商家的Stripe账户；VibeCart无需成为记录商户。

架构以协议为先：一个可信的商业后端，然后围绕它构建轻量级的MCP/UCP/客户端适配器。

生产环境实时功能

通用MCP

端点：https://vibecart.vercel.app/mcp

工具：

• vibecart.list_products

• vibecart.get_product

• vibecart.get_integration_instructions

• vibecart.create_checkout

vibecart.create_checkout 支持传统的单产品输入和可信的多项目 items[] 输入。产品价格在服务器端解析；调用者不提供真实的交易价格。

通用MCP客户端应使用 /mcp。

持久化购物车

VibeCart基于Neon的购物车已在生产环境中运行：

• POST /api/cart

• GET /api/cart/:id

• PATCH /api/cart/:id

• DELETE /api/cart/:id

• POST /api/cart/:id/checkout

购物车使用可信的服务器端重新定价、幂等创建、乐观版本检查、过期机制、多项目状态以及购物车到Stripe Checkout的交接。

UCP

• 发现：https://vibecart.vercel.app/.well-known/ucp

• 支持UCP的MCP传输：https://vibecart.vercel.app/ucp/mcp

• 已发布的协议目标：UCP 2026-04-08

生产环境广告发布已发布的目录和购物车能力。当前购物车工具包括：

• create_cart

• get_cart

• update_cart

• cancel_cart

UCP调用需要 meta.ucp-agent.profile 和能力协商。不要将普通MCP客户端指向 /ucp/mcp。

订单流水线和已发布模式的 get_order 适配器也存在，但 get_order 仍处于隐藏状态，直到其VibeCart Cloud查找和真实商家永久链接依赖项配置完毕。VibeCart不会在其运行时依赖项就绪之前广告可选能力。

Stripe结账与订单

• 支持可信的多行Stripe Checkout创建。

• 在付费事件进入支付后流水线之前，验证Stripe webhook签名。

• 延迟支付完成单独处理，以免过早创建订单。

• 当配置了VibeCart Cloud转发时，付费结账行项目被标准化为持久化订单记录。

• 可信的商家产品ID通过Stripe产品元数据在结账过程中存活。

Related MCP server: Shopify Agentic MCP Gateway

代理客户端分发

VibeCart 不为每个模型构建不同的商业引擎。OpenAI/Codex/ChatGPT、Claude、Gemini、VS Code、Cursor以及其他MCP客户端连接到同一个后端。

参见：

• docs/integrations/agent-clients.md

• integrations/mcp-clients.json

• https://vibecart.vercel.app/mcp-clients.json

提供商适配器经过CI检查，以确保Stripe/数据库密钥和重复的商业逻辑不会出现在客户端配置中。

VibeCart Cloud

VibeCart Core可免费自托管。VibeCart Cloud是可选的每月29美元托管层，适用于希望VibeCart运营重复性管道的商家。

当前Cloud能力包括：

• 持久化的已验证商业事件

• 持久化的标准化付费订单记录和订单历史

• 服务器到服务器的订单查找

• 签名的商家履行webhook

• 交付历史和有限重试

• 监控/告警和支持工作流

Cloud工作区：https://vibecart-cloud-uupzkh.v2.appdeploy.ai/

商家结账收入仍直接结算到商家的Stripe账户。VibeCart不抽取商家销售额的任何百分比。

快速开始

npm install
npm run dev

没有Stripe密钥时，结账以明确标记的演示模式运行。如需实时支付，请在托管提供商的密钥/环境设置中配置 STRIPE_SECRET_KEY。切勿提交密钥值。

有用的公共端点：

• /mcp — 通用MCP传输/发现

• /api/cart — 持久化购物车创建

• /.well-known/ucp — UCP业务发现

• /ucp/mcp — 支持UCP的MCP传输

• /mcp-clients.json — 机器可读的客户端兼容性清单

• /llms.txt — 简洁的机器可读集成说明

• /agents.md — 面向代理的指南

• /api/health — 不包含密钥值的布尔就绪状态

• /cloud — 托管Cloud产品

安全模型

• 商家拥有Stripe账户并直接接收商家资金。

• 可信价格来自服务器端商家目录状态。

• 客户端提供的定价默认禁用，仅在服务器端显式启用时为原型模式。

• 在支付后处理之前验证Stripe webhook签名。

• 购物车状态是持久化且版本化的，而非信任浏览器/代理。

• Cloud集成凭据保留在服务器端。

• 公共健康/发现端点暴露就绪布尔值/能力，而非凭据值。

• 可选UCP能力仅在其运行时依赖项有效时才进行广告。

协议合规性

CI固定已发布的UCP v2026-04-08 源代码，并通过官方 ucp-schema 验证器执行VibeCart的真实映射器。购物车成功/错误负载、目录响应、发现以及私有订单映射器具有发布固定的合规性门控。

当前参考限制

• 商家目录仍是一个小型参考目录，而非完整的多商家目录服务。

• 库存、自动税费计算、运费计算、退货/退款以及完整的履行生命周期尚未作为平台服务完成。

• 公共UCP订单查找仍处于激活门控状态，直到其Cloud/永久链接运行时依赖项配置完毕。

• Next.js App Router是参考实现；其他框架应使用围绕相同Core协议表面的适配器，而非分叉商业逻辑。

北极星

VibeCart：面向每个AI代理的商业基础设施。一次构建。在AI能行动的任何地方销售。

许可证

MIT — 根据许可证条款，可自由使用、修改、分发、再许可和销售。