MCP Stripe Server

基本能力

产品定位

MCP Stripe Server 是一个专注于金融交易处理的 MCP 服务，特别适用于需要集成 Stripe 支付系统的应用场景。

核心功能

• 客户管理：创建、检索和更新客户信息。
• 支付操作：创建支付意图和列出最近的支付记录。
• 退款操作：为支付创建退款。
• 审计日志：记录所有 Stripe 操作的审计日志，支持结构化日志记录。
• 错误处理：提供清晰的错误消息，处理常见错误场景。

适用场景

• 电子商务平台的支付处理
• 订阅服务的客户管理和支付处理
• 需要审计金融交易的应用

工具列表

• customer_create：创建新客户。
• customer_retrieve：检索客户详细信息。
• customer_update：更新客户信息。
• payment_intent_create：创建支付意图。
• charge_list：列出最近的支付记录。
• refund_create：为支付创建退款。

常见问题解答

• Missing API Key：需要设置 STRIPE_API_KEY。
• Invalid API Key：API 密钥无效。
• Customer not found：客户 ID 无效。
• Invalid input：缺少或参数不正确。

使用教程

使用依赖

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

安装教程

1. 通过 Smithery 安装：

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

1. 安装依赖：

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

1. 配置环境变量：

STRIPE_API_KEY=your_stripe_secret_key

调试方式

1. 启动服务器：

uv run src/server.py

1. 使用 MCP Inspector 进行交互式测试：

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。