MCP Stripe 服务器

一个模型上下文协议 (MCP) 服务器实现，集成了 Stripe 用于处理支付、客户和退款。此服务器提供了一个结构化的 API 来安全地管理金融交易。

演示

要求

• Python 3.8+
• MCP SDK 0.1.0+
• Stripe Python SDK
• dotenv

组件

资源

服务器提供所有 Stripe 操作的审计日志记录：

• 存储客户、支付和退款操作的审计日志
• 支持结构化日志记录以实现更好的可追溯性
• 使用 MCP 资源端点来检索审计数据

工具

服务器实现了 Stripe API 操作，包括：

客户管理

• customer_create: 创建新客户
• customer_retrieve: 检索客户的详细信息
• customer_update: 更新客户信息

支付操作

• payment_intent_create: 创建用于处理付款的支付意图
• charge_list: 列出最近的收费

退款操作

• refund_create: 为收费创建退款

特性

• 安全支付: 与 Stripe 集成以实现强大的支付处理
• 审计日志记录: 跟踪所有 Stripe 交易
• 错误处理: 具有清晰消息的全面错误处理
• MCP 集成: 支持 MCP 兼容的工具和资源列表

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Stripe Server：

npx -y @smithery/cli install @atharvagupta2003/mcp-stripe --client claude

安装依赖

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
pip install -e .

配置

在 .env 文件中设置环境变量：

STRIPE_API_KEY=your_stripe_secret_key

Claude Desktop

将服务器配置添加到您的 Claude Desktop 配置中：

Windows: C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src",
        "run",
        "server.py"
      ]
    }
  }
}

用法

启动服务器

uv run src/server.py

示例 MCP 命令

创建一个客户

{
    "tool": "customer_create",
    "arguments": {
        "email": "customer@example.com",
        "name": "John Doe"
    }
}

检索一个客户

{
    "tool": "customer_retrieve",
    "arguments": {
        "customer_id": "cus_123456"
    }
}

创建一个支付意图

{
    "tool": "payment_intent_create",
    "arguments": {
        "amount": 5000,
        "currency": "usd",
        "customer": "cus_123456"
    }
}

创建一个退款

{
    "tool": "refund_create",
    "arguments": {
        "charge_id": "ch_abc123"
    }
}

错误处理

服务器为常见场景提供清晰的错误消息：

• 缺少 API 密钥: 需要 STRIPE_API_KEY
• 无效的 API 密钥: 身份验证错误
• 未找到客户: 无效的客户 ID
• 无效输入: 缺少或不正确的参数

开发

测试

运行 MCP Inspector 进行交互式测试：

npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src run server.py

构建

1. 更新依赖项：

uv compile pyproject.toml

2. 构建包：

uv build

贡献

欢迎贡献！ 请参阅我们的 贡献指南 了解详情。

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。