Braintree MCP 服务器

一个非官方的模型上下文协议（MCP）服务器，用于通过GraphQL API与PayPal Braintree支付处理服务进行交互。

概述

此服务器实现模型上下文协议（MCP）规范，以便AI助理模型能够直接访问Braintree的支付处理功能。它使AI系统能够执行诸如获取交易、创建支付和管理客户数据等操作。

要求

• Python 3.13+
• Braintree商家账户凭证

安装

1. 克隆此仓库

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

2. 设置Python 3.13+环境

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

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

3. 安装依赖项

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的服务。