内容
# Stripe MCP 服务器
一款连接 Claude（或任何 MCP 客户端）到您的 Stripe 账户的模型上下文协议（MCP）服务器。查询客户、收入、发票、订阅、纠纷和退款 — 所有操作均通过自然语言进行。
## 要求
- Node.js 18+
- 具有秘密 API 密钥的 Stripe 账户
## 安装
```bash
git clone https://github.com/your-username/stripe-mcp-server.git
cd stripe-mcp-server
npm install
cp .env.example .env
# 编辑 .env 并设置 STRIPE_SECRET_KEY
```
## 手动运行
```bash
STRIPE_SECRET_KEY=sk_live_... node index.js
```
## Claude 桌面配置
将以下内容添加到您的 `claude_desktop_config.json`（macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"stripe": {
"command": "node",
"args": ["/absolute/path/to/stripe-mcp-server/index.js"],
"env": {
"STRIPE_SECRET_KEY": "sk_live_..."
}
}
}
}
```
编辑完成后重启 Claude 桌面。
## 工具
| 工具 | 描述 | 参数 |
|------|-------------|------------|
| `list_customers` | 列出最近的 Stripe 客户 | `limit`（1–100，默认 10） |
| `get_revenue` | 获取指定日期范围内成功收费的总收入 | `from`（YYYY-MM-DD），`to`（YYYY-MM-DD） |
| `list_invoices` | 按状态列出发票（`open` = 未付） | `status`（draft | open | paid | uncollectible | void） |
| `list_failed_payments` | 列出最近失败的收费及失败原因 | `limit`（1–100，默认 10） |
| `get_subscription` | 获取客户的所有订阅 | `customer_id`（例如，`cus_...`） |
| `create_refund` | 发起全额或部分退款 | `charge_id`（例如，`ch_...`），`amount`（美分，可选） |
| `list_disputes` | 列出纠纷/退款争议及证据截止日期 | `limit`（1–100，默认 10） |
## 示例提示
- *"列出我的最后 20 位客户"*
- *"2025 年 5 月份我的收入是多少？"*
- *"显示我所有未付发票"*
- *"最近有哪些失败的付款？"*
- *"获取客户 cus_ABC123 的订阅"*
- *"退款 charge ch_XYZ 10 美元"*
- *"有任何开放的纠纷吗？"*
## 安全
- 永远不要提交您的 `.env` 文件或硬编码您的秘密密钥。
- 使用仅具有您所需权限的**受限密钥**。
- 在开发中使用 `sk_test_...` 密钥。
## 许可证
MIT
