AI导哈

支付处理服务器

一个与Stripe集成的MCP服务器实现，用于安全处理支付、客户管理和退款操作。

  • by atharvagupta2003
  • Python
  • 本地部署
  • 44 星标
  • 更新于
在 GitHub 查看 atharvagupta2003/mcp-stripe

使用说明

MCP条带服务器

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

演示

需求

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

组件

资源

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

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

工具

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

客户管理

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

支付操作

  • payment_intent_create：创建用于处理付款的付款意图
  • charge_list：列出最近的指控

退款操作

  • reund_create：创建费用退款

特性

  • 安全付款：与Stripe集成，实现稳健的支付处理
  • 审计日志：跟踪所有Stripe交易
  • 错误处理：全面的错误处理，信息清晰
  • MCP集成：支持MCP兼容的工具和资源列表

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的Stripe服务器 史密瑟里:

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配置中：

Windows:C:\用户＜用户名＞\AppData\Roaming\Claude\Claude_desktop_config json

MacOS:~/库/应用程序支持/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检查器进行交互式测试：

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

建筑

  1. 更新依赖关系：
uv compile pyproject.toml
  1. 构建包：
uv build

贡献

我们欢迎捐款！请查看我们的 贡献指南 了解详情。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP