Braintree MCP Server

🚀 Braintree MCP サーバー

非公式のモデルコンテキストプロトコル（MCP）サーバーで、GraphQL APIを通じてPayPal Braintreeの支払い処理サービスとやり取りすることができます。

🚀 クイックスタート

このサーバーは、AIアシスタントモデルがBraintreeの支払い処理機能に直接アクセスできるように、モデルコンテキストプロトコル（MCP）仕様を実装しています。これにより、AIシステムは取引の取得、支払いの作成、顧客データの管理などの操作を実行できます。

✨ 主な機能

• AIアシスタントモデルがBraintreeの支払い処理機能に直接アクセスできるようにする。
• 取引の取得、支払いの作成、顧客データの管理などの操作をサポートする。
• 簡単な接続テストや任意のGraphQLクエリの実行が可能。

📦 インストール

必要条件

• 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のサービスを許可なく使用するものではありません。