MCP Stripe Server

这是一个与Stripe集成以处理支付、客户和退款的Model Context Protocol (MCP)服务器实现。该服务器提供了一个结构化的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自动安装Stripe Server for Claude Desktop：

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

安装依赖项

python -m venv venv
source venv/bin/activate  # 在macOS/Linux上
venv\Scripts\activate    # 在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文件。