Stripe

🚀 MCP Stripe 服務器

MCP Stripe 服務器是一個與 Stripe 集成的 Model Context Protocol (MCP) 服務器實現，可處理支付、客戶和退款等業務。它提供了結構化的 API，能安全地管理財務交易。

🚀 快速開始

安裝

使用 Smithery 安裝

通過 Smithery 自動安裝 Claude Desktop 的 Stripe 服務器：

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

安裝依賴項

python -m venv venv
source venv/bin/activate  # 在 macOS/Linux 上
venv\Scripts\activate    # 在 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

✨ 主要特性

• 安全支付：與 Stripe 集成以實現穩健的支付處理。
• 審計日誌：記錄所有 Stripe 交易。
• 錯誤處理：全面的錯誤處理，帶有清晰的消息。
• MCP 集成：支持兼容 MCP 的工具和資源列表。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 自動安裝 Claude Desktop 的 Stripe 服務器：

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

安裝依賴項

python -m venv venv
source venv/bin/activate  # 在 macOS/Linux 上
venv\Scripts\activate    # 在 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"
      ]
    }
  }
}

💻 使用示例

基礎用法

MCP 示例命令

創建客戶

{
    "tool": "customer_create",
    "arguments": {
        "email": "customer@example.com",
        "name": "John Doe"
    }
}

檢索客戶

{
    "tool": "customer_retrieve",
    "arguments": {}
}

更新客戶

{
    "tool": "customer_update",
    "arguments": {
        "id": "customer_id",
        "email": "new_email@example.com"
    }
}

創建退款

{
    "tool": "refund_create",
    "arguments": {
        "charge_id": "charge_123"
    }
}

支付意圖創建

uv payment_intent_create --amount 100 --currency usd

費用列表

uv charge_list

📚 詳細文檔

演示

需求

• 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：為一筆收費創建退款。

🔧 技術細節

錯誤處理

• 參數錯誤：當傳遞無效參數時，服務器返回 400 錯誤。
• 權限錯誤：未授權訪問資源時，返回 401 錯誤。
• 內部錯誤：服務器在處理請求時出現內部錯誤時，返回 500 錯誤。

📄 許可證

保留所有權利。禁止未經授權的複製或分發。

徽章