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自动为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

1. 构建包：

uv build

贡献

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

许可证

该项目根据MIT许可证发布 - 详情请见LICENSE文件。