stripekit

Name: stripekit
Author: rafaelcg

本地服务

github.com/rafaelcg金融数据212 周前更新

代码仓库

关于 stripekit

stripekit 是用于以配置文件管理 Stripe 商品目录和账单代码的命令行工具，面向开发者与编码 Agent。它可规划、推送、拉取和检查账户状态，并通过 `init` 为 Next.js App Router 项目生成账单代码。

主要功能

01声明式管理 Stripe 目录
02规划、推送与拉取配置
03检查账户与配置差异
04生成 Next.js 账单代码
05本地转发 Stripe Webhook

适用场景

01将仓库配置同步到 Stripe 账户
02为 Next.js 应用搭建结账流程
03检查密钥、Webhook 和门户设置

MCP 相关

`stripekit mcp` 提供 MCP 服务，将 `plan`、`push`、`pull` 和 `check` 操作作为工具供 Agent 调用。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "rafaelcg-stripekit": {
      "command": "npx",
      "args": [
        "-y",
        "stripekit"
      ]
    }
  }
}

启动命令npx -y stripekit

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

安装包

npmstripekit0.2.2stdio

工具

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

参数	类型	必填	说明
cwd	string	否	包含 stripe.config.ts 的项目目录（默认使用服务器工作目录）。
url	string	否	解析 webhook 端点时使用的基础 URL。

详细介绍

stripekit

Stripe 版的 create-next-app。 一条命令即可让应用从零开始使用 Stripe 处理付款：它会根据仓库中的配置文件为你的 Stripe 账户创建商品目录，并加入结构正确、由你掌控的计费代码。无需托管服务，无需分成，也没有任何运行时依赖。无论由人还是 Agent 运行，效果都一样。

文档 →

仓库布局

路径	内容
`packages/stripekit`	`stripekit` npm 包 — CLI 和配置 API。
`examples/playground`	用于在 Stripe 测试账户上试用 stripekit 的临时项目。
`docs`	VitePress 文档站点。
`DESIGN.md`	MVP 设计：CLI 接口、配置架构、生成的代码和构建顺序。

状态

协调器（plan / push / pull）— 将你的 Stripe 账户与声明式的 stripe.config.ts（商品、价格、webhook 端点、客户门户）进行协调；将价格视为不可变对象，采用归档而非删除，并以幂等方式收敛。
init — 在 Next.js App Router 应用中搭建 stripe.config.ts，并加入结构正确的计费代码（webhook 处理程序、状态同步、结账／门户路由）。
dev — 封装 stripe listen，在本地转发 webhook 并获取签名密钥。
check — 诊断工具，用于验证密钥、配置有效性、配置与账户的差异，以及 webhook／门户接线。

此外还有一个 VitePress 文档站点，包含一个首页 — 运行 pnpm docs:dev 即可启动。路线图（参见 DESIGN.md）：支持 Next.js 以外的 init，以及更丰富的商品目录功能。

使用方法请参阅软件包 README。

面向 AI Agent

stripekit 专为 Agent 操作而构建，不仅仅面向人类：

llms.txt 和 llms-full.txt — 提供整洁的 Markdown 文档，供大模型作为上下文使用。
SKILL.md — 将此文件提供给你的编码 Agent，即可让它为你配置 stripekit。
stripekit mcp — 一个 MCP 服务，将 plan／push／pull／check 作为 Agent 可调用的工具公开。
每条命令都支持 --json 和 --yes，便于确定性、非交互式地使用。

在 Cursor 中一键安装 MCP 服务：

……或者将其作为插件安装到 Claude Code：

/plugin marketplace add rafaelcg/stripekit
/plugin install stripekit@stripekit-marketplace

其他客户端（Claude Desktop、.cursor/mcp.json、claude mcp add）请参阅 MCP 文档。

如果你正在开发 stripekit，请参阅 AGENTS.md。

开发

pnpm install
pnpm -C packages/stripekit build      # bundle CLI + types
pnpm -C packages/stripekit test       # unit + integration tests
pnpm -C packages/stripekit typecheck