Stripe MCP

Name: Stripe MCP
Author: robinafaruqia

本地服务

npmjs.com金融数据24 周前更新

代码仓库访问官网

关于 Stripe MCP

Stripe MCP 是用于查询 Stripe 客户、付款、订阅、发票和退款数据的只读服务，面向需要访问 Stripe 测试账户的 MCP 客户端，并拒绝实时密钥。

主要功能

01查询客户和付款
02获取订阅和发票
03列出退款
04拒绝实时密钥
05单文件实现，无需构建

适用场景

01检查近期客户和付款记录
02查看客户的订阅和发票
03检查某笔付款的退款

MCP 相关

向 MCP 客户端提供只读 Stripe 查询工具。配置时需使用 Stripe 测试密钥；服务会拒绝实时密钥。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "robinafaruqia-stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@devtechtricks/stripe-mcp"
      ],
      "env": {
        "STRIPE_SECRET_KEY": "<STRIPE_SECRET_KEY>"
      }
    }
  }
}

启动命令npx -y @devtechtricks/stripe-mcp

需要配置的环境变量

STRIPE_SECRET_KEY密钥Stripe test-mode secret or restricted key (sk_test_ or rk_test_)

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

安装包

npm@devtechtricks/stripe-mcp0.1.2stdio

工具

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

参数	类型	必填	说明
email	string	否	按客户邮箱精确筛选
limit	number	否	最大结果数（1-100）

详细介绍

stripe-mcp

用于查询 Stripe 客户、付款、订阅、发票和退款的只读 MCP 服务。

可与任何支持 MCP（Model Context Protocol）的 AI 或客户端搭配使用，例如 Cursor、Claude Desktop、Claude Code、Windsurf 或其他 MCP 宿主。

功能

采用只读设计 — 不提供扣款、退款、更新或删除工具
仅支持测试密钥 — 遇到 sk_live_ / rk_live_ 时会拒绝启动
单文件 — 仅需 index.js，无需构建
适用于任何 MCP 客户端 — Cursor、Claude、Windsurf 等

Cursor 插件

此仓库是一个 Agent Plugin 和 Cursor 插件。cursor.directory 仅检测提交到仓库根目录的组件。它需要以下文件：

文件	用途
`mcp.json`	MCP 服务条目（`npx -y @devtechtricks/stripe-mcp`）
`plugin.json`	Open Plugins 清单
`.cursor-plugin/plugin.json`	Cursor 列表元数据和 `STRIPE_SECRET_KEY` 变量

将这些文件提交到公开 GitHub 仓库的默认分支后，请在 cursor.directory/plugins/new 提交 https://github.com/robinafaruqia/stripe-mcp。安装时，将 STRIPE_SECRET_KEY 设置为 Stripe 测试密钥（sk_test_... 或 rk_test_...）。

MCP 配置

Cursor — 一键安装

安装后，从 Stripe Dashboard 获取 Stripe 测试密钥（sk_test_... 或 rk_test_...），替换 YOUR_STRIPE_TEST_KEY。建议使用仅具有读取权限范围的受限密钥。

使用 npx（推荐）

将其添加到 MCP 客户端配置中（例如，Cursor：~/.cursor/mcp.json 或“设置” → MCP；Claude：claude_desktop_config.json；等等）：

{
  "mcpServers": {
    "stripe-mcp": {
      "command": "npx",
      "args": ["-y", "@devtechtricks/stripe-mcp"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Claude Code：

claude mcp add stripe-mcp --env STRIPE_SECRET_KEY=sk_test_... -- npx -y @devtechtricks/stripe-mcp

从源代码运行（开发）

git clone https://github.com/robinafaruqia/stripe-mcp.git
cd stripe-mcp
npm install
cp .env.example .env   # then put your sk_test_ / rk_test_ key in .env

然后在 MCP 配置中：

{
  "mcpServers": {
    "stripe-mcp": {
      "command": "node",
      "args": ["/path/to/stripe-mcp/index.js"]
    }
  }
}

如果尚未设置 STRIPE_SECRET_KEY，index.js 会从软件包目录加载 .env。npm 安装不包含 .env — MCP 客户端应通过 env 传递密钥。

可用工具

工具	描述
`list_customers`	列出最近的客户。可选：`limit`、`email`。
`get_customer`	按 ID 获取客户。必需：`customer_id`。
`list_payments`	列出最近的付款意图。可选：`limit`、`customer_id`。
`get_payment`	按 ID 获取付款意图。必需：`payment_intent_id`。
`list_subscriptions`	列出订阅。可选：`limit`、`customer_id`、`status`。
`get_subscription`	按 ID 获取订阅。必需：`subscription_id`。
`list_invoices`	列出发票。可选：`limit`、`customer_id`、`status`。
`list_refunds`	列出退款。可选：`limit`、`payment_intent_id`。

示例

1. list_customers({ limit: 5 })
2. get_customer({ customer_id: "cus_ABC123" })
3. list_subscriptions({ customer_id: "cus_ABC123" })
4. list_payments({ limit: 10 })