Stripe Server 使用说明

项目简介

Stripe Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，旨在为大型语言模型（LLM）应用提供与 Stripe 支付平台集成的能力。通过 Stripe Server，LLM 应用可以安全地管理客户信息、处理支付流程以及执行退款操作。该服务器充当 LLM 应用与 Stripe API 之间的桥梁，以结构化和标准化的方式提供金融交易相关的上下文信息和功能。

主要功能点

安全支付集成: 利用 Stripe 强大的支付处理能力，安全可靠地处理各种支付操作。
客户管理: 提供创建、检索和更新 Stripe 客户信息的功能。
支付操作: 支持创建支付意图和查询交易记录。
退款处理: 允许创建和管理退款请求。
操作审计日志: 记录所有 Stripe 操作，方便追踪和审计。
错误处理: 提供清晰的错误信息，帮助开发者快速定位和解决问题。
MCP 协议支持: 完全兼容 MCP 协议，可以与任何支持 MCP 协议的 LLM 客户端（如 Claude Desktop）无缝集成。

安装步骤

通过 Smithery 安装 (Claude Desktop 自动安装)

如果您使用 Claude Desktop，可以通过 Smithery 快速安装 Stripe Server：

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

手动安装

安装 Python 依赖: 确保您已安装 Python 3.8 或更高版本。使用 venv 创建虚拟环境并激活：

python -m venv venv
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate    # Windows

然后安装项目依赖：

pip install -e .

配置环境变量: 在项目根目录下创建 '.env' 文件，并填入您的 Stripe API 密钥：
```
STRIPE_API_KEY=your_stripe_secret_key
```
请替换 'your_stripe_secret_key' 为您在 Stripe 后台获取的 Secret key。

服务器配置 (Claude Desktop)

要将 Stripe Server 集成到 Claude Desktop，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

Windows: 'C:\Users<用户名>\AppData\Roaming\Claude\claude_desktop_config.json'
MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

在 'claude_desktop_config.json' 文件中，找到 '"mcpServers"' 部分并添加 Stripe Server 的配置。如果 'mcpServers' 不存在，请创建它。

{
  "mcpServers": {
    "stripe": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src",
        "run",
        "server.py"
      ]
    }
  }
}

配置参数说明:

'"stripe"': 服务器名称，您可以自定义，用于在 Claude Desktop 中标识该服务器。
'"command": "uv"': 指定用于启动服务器的命令。这里使用 'uv' (基于 Rust 的 Python 包安装和运行工具，需预先安装 uv，或者替换为 'python')。
'"args"': 启动服务器的参数列表。
- '"--directory"': 指定服务器代码所在的目录的绝对路径。请将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/src' 替换为 Stripe Server 项目 'src' 目录的实际绝对路径。例如，如果您的 Stripe Server 项目放在 'D:\projects\mcp-stripe'，则应替换为 'D:\projects\mcp-stripe\src'。
- '"run"': 'uv run' 的子命令，用于运行 Python 脚本。
- '"server.py"': 指定要运行的服务器脚本文件。

注意: 请务必将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/src' 替换为正确的绝对路径。 Claude Desktop 需要通过此配置信息才能正确启动 Stripe Server。

基本使用方法

启动服务器: 打开终端，进入 Stripe Server 项目根目录，激活虚拟环境（如果尚未激活），然后运行以下命令启动服务器：
```
uv run src/server.py
```
或者，如果您没有安装 'uv'，可以使用 'python' 命令：
```
python src/server.py
```
服务器成功启动后，将开始监听来自 MCP 客户端的请求。

通过 MCP 客户端 (例如 Claude Desktop) 与服务器交互: 在 Claude Desktop 中配置并启用 Stripe Server 后，您可以使用自然语言指令，通过 Claude 调用 Stripe Server 提供的工具。例如，您可以指示 Claude 创建客户、发起支付或查询交易记录。Claude Desktop 会将您的指令转换为 MCP 命令发送给 Stripe Server，服务器处理请求后将结果返回给 Claude。

示例 MCP 命令 (供参考，实际使用由 Claude Desktop 自动生成和发送):

创建客户:

{
    "tool": "customer_create",
    "arguments": {
        "email": "[email protected]",
        "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"
    }
}

通过以上步骤，您就可以成功安装、配置和使用 Stripe Server，为您的 LLM 应用增加强大的金融交易处理能力。

关键词