Stripe 模型上下文协议

Stripe 的 模型上下文协议 服务器允许您通过函数调用集成 Stripe API。此协议支持各种工具与不同的 Stripe 服务进行交互。

配置

Stripe 在 https://mcp.stripe.com 主持一个远程 MCP 服务器。此处 查看文档。要使用 npx 在本地运行 Stripe MCP 服务器，请使用以下命令：

# 设置所有可用工具
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

# 设置特定工具
npx -y @stripe/mcp --tools=customers.create,customers.read,products.create --api-key=YOUR_STRIPE_SECRET_KEY

# 配置 Stripe 连接账户
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY --stripe-account=CONNECTED_ACCOUNT_ID

请确保将 YOUR_STRIPE_SECRET_KEY 替换为您实际的 Stripe 秘钥。或者，您可以设置环境变量中的 STRIPE_SECRET_KEY。

使用 Claude Desktop

在您的 claude_desktop_config.json 中添加以下内容。更多详情请参见 这里。

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
          "-y",
          "@stripe/mcp",
          "--tools=all",
          "--api-key=STRIPE_SECRET_KEY"
      ]
    }
  }
}

如果您使用 Docker，则添加如下内容：

{
    “mcpServers”: {
        “stripe”: {
            “command”: “docker",
            “args”: [
                “run”,
                "--rm",
                "-i",
                “mcp/stripe”,
                “--tools=all”,
                “--api-key=STRIPE_SECRET_KEY”
            ]
        }
    }
}

使用 Gemini CLI

1. 通过您喜欢的方法安装 Gemini CLI。
2. 安装 Stripe MCP 扩展：gemini extensions install https://github.com/stripe/agent-toolkit。
3. 启动 Gemini CLI：gemini。
4. 通过 OAUTH 流程：/mcp auth stripe。

可用工具

工具	描述
balance.read	获取余额信息
coupons.create	创建新的优惠券
coupons.read	读取优惠券信息
customers.create	创建新客户
customers.read	读取客户信息
disputes.read	读取争议信息
disputes.update	更新现有争议
documentation.read	搜索 Stripe 文档
invoiceItems.create	创建新的发票项目
invoices.create	创建新的发票
invoices.read	读取发票信息
invoices.update	更新现有发票
paymentIntents.read	读取支付意图信息
paymentLinks.create	创建新的支付链接
prices.create	创建新的价格
prices.read	读取价格信息
products.create	创建新产品
products.read	读取产品信息
refunds.create	创建新的退款
subscriptions.read	读取订阅信息
subscriptions.update	更新订阅信息

调试服务器

要调试您的服务器，可以使用 MCP Inspector。

首先构建服务器

npm run build

在终端中运行以下命令：

# 启动 MCP Inspector 和带有所有工具的服务器
npx @modelcontextprotocol/inspector node dist/index.js --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

使用 Docker 构建

首先构建服务器

docker build -t mcp/stripe .

在终端中运行以下命令：

docker run -p 3000:3000 -p 5173:5173 -v /var/run/docker.sock:/var/run/docker.sock mcp/inspector docker run --rm -i mcp/stripe --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

指南

1. 将 YOUR_STRIPE_SECRET_KEY 替换为您实际的 Stripe API 秘钥。
2. 运行命令以启动 MCP Inspector。
3. 在浏览器中打开 MCP Inspector UI 并点击连接以启动 MCP 服务器。
4. 您可以看到您选择的工具列表，并单独测试每个工具。