Braintree MCP Server

🚀 Braintree MCP 服務器

這是一個非官方的模型上下文協議（MCP）服務器，用於藉助 GraphQL API 與 PayPal Braintree 支付處理服務進行交互，能讓 AI 系統方便地使用支付處理功能。

🚀 快速開始

此服務器實現了模型上下文協議（MCP）規範，可讓 AI 助理模型直接訪問 Braintree 的支付處理功能，使 AI 系統能執行獲取交易、創建支付和管理客戶數據等操作。

✨ 主要特性

• 實現模型上下文協議（MCP）規範，便於 AI 助理模型與 Braintree 交互。
• 提供多種 MCP 工具，如連通性測試和執行任意 GraphQL 查詢。
• 支持常見的 GraphQL 操作，如獲取客戶信息和創建交易。

📦 安裝指南

克隆倉庫

git clone https://github.com/yourusername/braintree-mcp-server.git
cd braintree-mcp-server

設置 Python 3.13+ 環境

# 如果使用 pyenv
pyenv install 3.13.0
pyenv local 3.13.0

# 或使用其他方法確保使用 Python 3.13+

安裝依賴項

pip install -e .

📚 詳細文檔

配置

在項目根目錄中創建一個 .env 文件，其中包含您的 Braintree 憑證：

BRAINTREE_MERCHANT_ID=your_merchant_id
BRAINTREE_PUBLIC_KEY=your_public_key
BRAINTREE_PRIVATE_KEY=your_private_key
BRAINTREE_ENVIRONMENT=sandbox  # 或 production

您可以在 Braintree 控制面板中獲取這些憑證。

使用方法

運行服務器

python braintree_server.py

該服務器使用 stdio 傳輸默認運行，適合與支持 MCP 的 AI 助理系統集成。

可用的 MCP 工具

基礎用法

# braintree_pong：簡單的連通性測試，用於檢查Braintree憑證是否正常工作
響應 = await braintree_pong()
# 成功返回“pong”

高級用法

# braintree_execute_graphql：對Braintree API執行任意GraphQL查詢
查詢 = """
query GetTransactionDetails($id: ID!) {
  node(id: $id) {
    ... on Transaction {
      id
      status
      amount {
        value
        currencyCode
      }
      createdAt
    }
  }
}
"""

變量 = {"id": "transaction_id_here"}

響應 = await braintree_execute_graphql(查詢, 變量)
# 返回Braintree的JSON響應

常見 GraphQL 操作

獲取客戶信息

query GetCustomer($id: ID!) {
  node(id: $id) {
    ... on Customer {
      id
      firstName
      lastName
      email
      paymentMethods {
        edges {
          node {
            id
            details {
              ... on CreditCardDetails {
                last4
                expirationMonth
                expirationYear
                cardType
              }
            }
          }
        }
      }
    }
  }
}

創建交易

mutation CreateTransaction($input: ChargePaymentMethodInput!) {
  chargePaymentMethod(input: $input) {
    transaction {
      id
      status
      amount {
        value
        currencyCode
      }
    }
  }
}

帶變量：

{
  "input": {
    "paymentMethodId": "payment_method_id_here",
    "transaction": {
      "amount": "10.00",
      "orderId": "order123",
      "options": {
        "submitForSettlement": true
      }
    }
  }
}

故障排除

• 確保 .env 文件中的 Braintree 憑證正確無誤。
• 驗證網絡連接是否能夠訪問 Braintree 的 API 端點。
• 檢查是否有任何速率限制或權限問題與您的 Braintree 賬戶相關。

注意

此為非官方集成，未經授權使用 PayPal 或 Braintree 的服務。

⚠️ 重要提示

此為非官方集成，未經授權使用 PayPal 或 Braintree 的服務。

💡 使用建議

在使用前，務必確保 .env 文件中的 Braintree 憑證正確，並且網絡連接可以正常訪問 Braintree 的 API 端點。