Stripe MCP

MCP条带服务器

](https://smithery.ai/server/@atharvagupta2003/mcp-stripe)

一种模型上下文协议（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许可证获得许可-请参阅 许可证 文件以获取详细信息。