Braintree MCP 服务器

一个非官方的 Model Context Protocol (MCP) 服务器，用于与 PayPal Braintree 支付处理服务交互。

概述

该服务器实现了 Model Context Protocol (MCP) 规范，为 AI 助手模型提供通过 GraphQL API 直接、结构化地访问 Braintree 支付处理能力的方式。它使 AI 系统能够通过 MCP 工具执行支付操作，例如获取交易、创建支付和管理客户数据。

要求

• 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=您的商户ID
BRAINTREE_PUBLIC_KEY=您的公钥
BRAINTREE_PRIVATE_KEY=您的私钥
BRAINTREE_ENVIRONMENT=sandbox  # 或 production

您可以从 Braintree 控制面板获取这些凭据。

用法

运行服务器

python braintree_server.py

服务器默认使用 stdio 传输运行，这适用于与支持 MCP 的 AI 助手系统集成。

可用的 MCP 工具

braintree_ping

简单的连接性测试，用于检查您的 Braintree 凭据是否有效。

response = await braintree_ping()
# 如果成功，返回 "pong"

braintree_execute_graphql

针对 Braintree API 执行任意 GraphQL 查询。

query = """
query GetTransactionDetails($id: ID!) {
  node(id: $id) {
    ... on Transaction {
      id
      status
      amount {
        value
        currencyCode
      }
      createdAt
    }
  }
}
"""

variables = {"id": "transaction_id_here"}

response = await braintree_execute_graphql(query, variables)
# 返回来自 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
      }
    }
  }
}

故障排除

• 确保您的 Braintree 凭据在 .env 文件中正确
• 验证您的网络连接可以访问 Braintree 的 API 端点
• 检查您的 Braintree 帐户是否存在任何速率限制或权限问题

许可证

本项目仅用于演示目的。 在生产环境中使用风险自负。

免责声明

这是一个非官方的集成，未经 PayPal 或 Braintree 认可或附属。