braintree-mcp-server 是一个非官方的 Model Context Protocol（MCP）服务器，旨在让 AI 助手模型能够与 PayPal Braintree 支付处理服务进行交互。它实现了 MCP 规范，通过 Braintree 的 GraphQL API 为 AI 系统提供直接、结构化的支付操作访问，例如获取交易、创建支付和管理客户数据。
主要能力：
- 提供 MCP 工具，使 AI 模型可以执行 Braintree 支付相关操作。
- 支持通过 GraphQL API 执行任意查询，并包含常见 GraphQL 操作示例（如创建交易）。
- 提供简单的连通性测试工具，用于检查 Braintree 凭据是否有效。
服务器版本：
- STDIO 传输服务器（braintree_server.py）：使用标准输入/输出进行通信，专为与 Claude Desktop 及其他支持 STDIO 的 MCP 客户端集成而设计。每个客户端会话会启动一个新的服务器进程，客户端断开连接后服务器终止。使用方式：配置 claude_desktop_config.json 指向该服务器，然后在 Claude Desktop 中选择 Braintree 工具。
- SSE 传输服务器（braintree_sse_server.py）：使用 Server-Sent Events 进行通信，作为独立 Web 服务器运行，可处理多个客户端连接。服务器持续运行直到手动停止，默认绑定到 127.0.0.1:8001（可配置）。连接方式：使用支持 SSE 传输的 MCP 客户端连接到 http://127.0.0.1:8001/sse。
使用方式：
- 克隆仓库。
- 设置 Python 3.13+ 环境。
- 安装依赖（参见 requirements.txt）。
- 在项目根目录创建 .env 文件，填入从 Braintree 控制面板获取的凭据。
- 默认以 stdio 传输运行服务器，适用于支持 MCP 的 AI 助手系统集成。
- SSE 服务器提供基于 Web 的传输层，允许多个持久客户端连接，适用于需要多个客户端访问 Braintree 功能的独立部署。
适用场景：
- 将 Braintree 支付功能集成到 AI 助手工作流中。
- 通过 AI 模型自动化执行支付查询、创建交易和管理客户数据。
- 需要多客户端持久访问 Braintree 功能的独立部署场景。
限制与注意事项：
- 该项目为非官方项目。
- 使用前需确保 .env 文件中的 Braintree 凭据正确。
- 需验证网络连接可访问 Braintree API 端点。
- 需检查 Braintree 账户是否存在速率限制或权限问题。
- 许可证为 MIT，附加学术引用要求：学术或科学研究使用需按 CITATION.md 格式引用；商业及非学术使用遵循标准 MIT 条款。
- 具体依赖列表、环境变量名称及完整配置细节请参考仓库中的 requirements.txt、.env 示例及文档。
