Authorize Net MCP

🚀 authorize - net - mcp プロジェクトドキュメント

このプロジェクトは、Model Context Protocol (MCP) に基づくサーバープロジェクトです。Authorize.net Node SDK を統合し、2 つの主要な支払い機能を提供します。

1. takePayment - 即時決済（AUTH_CAPTURE）
2. createInvoice - 顧客がオンラインで支払うための管理済み請求書ページを生成

🚀 クイックスタート

このセクションでは、プロジェクトの起動手順を説明します。

1. 依存関係のインストール

npm install

2. 環境変数の設定

Authorize.net の API キーと設定を、以下のようにオペレーティングシステムに応じて設定します。

• Linux/MacOS:

export AUTHORIZE_NET_API_KEY=your_api_key_here
export AUTHORIZE_NET_CONFIG=path_to_your_config.json

• Windows (コマンドプロンプト):

set AUTHORIZE_NET_API_KEY=your_api_key_here
set AUTHORIZE_NET_CONFIG=path_to_your_config.json

• PowerShell:

$env:AUTHORIZE_NET_API_KEY="your_api_key_here"
$env:AUTHORIZE_NET_CONFIG="path_to_your_config.json"

3. サーバーの起動

npm start

✨ 主な機能

機能概要

このプロジェクトは、以下の 2 つの主要な支払い機能を提供します。

• 即時決済 (takePayment)：顧客のクレジットカードから指定された金額を直接引き落とします。
• 請求書生成 (createInvoice)：顧客が支払い情報を入力して取引を完了できる管理済みページのリンクを作成します。

モデルコンテキストプロトコル (MCP) の概要

MCP は、モデルとコンテキストデータを接続するためのプロトコルで、さまざまな環境での相互作用を可能にします。MCP を使用することで、さまざまなツールやサービスを簡単に呼び出すことができます。

📦 インストール

依存関係のインストール

npm install

環境変数の設定

オペレーティングシステムに応じて、Authorize.net の API キーと設定を設定します。

• Linux/MacOS:

export AUTHORIZE_NET_API_KEY=your_api_key_here
export AUTHORIZE_NET_CONFIG=path_to_your_config.json

• Windows (コマンドプロンプト):

set AUTHORIZE_NET_API_KEY=your_api_key_here
set AUTHORIZE_NET_CONFIG=path_to_your_config.json

• PowerShell:

$env:AUTHORIZE_NET_API_KEY="your_api_key_here"
$env:AUTHORIZE_NET_CONFIG="path_to_your_config.json"

サーバーの起動

npm start

💻 使用例

利用可能なツールの一覧表示

以下のコマンドを呼び出して、すべての利用可能な MCP ツールとその詳細情報を取得します。

{
  "command": "list_tools"
}

応答例:

{
  "tools": [
    {
      "name": "takePayment",
      "description": "顧客のクレジットカードから即時に支払いを引き落とします。",
      "parameters": [
        { "name": "amount", "type": "number", "required": true },
        { "name": "cardNumber", "type": "string", "required": true },
        { "name": "expirationDate", "type": "string", "required": true },
        { "name": "cardCode", "type": "string", "required": true }
      ]
    },
    {
      "name": "createInvoice",
      "description": "顧客がオンラインで支払うための管理済みページのリンクを作成します。",
      "parameters": [
        { "name": "amount", "type": "number", "required": true },
        { "name": "invoiceNumber", "type": "string", "required": true },
        { "name": "description", "type": "string", "required": true }
      ]
    }
  ]
}

takePayment ツールの呼び出し

リクエスト例:

{
  "command": "execute_tool",
  "tool_name": "takePayment",
  "args": {
    "amount": 19.99,
    "cardNumber": "4242424242424242",
    "expirationDate": "0825",
    "cardCode": "123"
  }
}

応答例:

{
  "status": "success",
  "transaction_id": "T20231017-123456"
}

createInvoice ツールの呼び出し

リクエスト例:

{
  "command": "execute_tool",
  "tool_name": "createInvoice",
  "args": {
    "amount": 50.0,
    "invoiceNumber": "INV-1001",
    "description": "T - shirt order"
  }
}

応答例:

{
  "status": "success",
  "url": "https://checkout.authorize.net/your_invoice_id"
}

📚 ドキュメント

プロジェクト構造

project/
├── src/                 # ソースコードディレクトリ
│   ├── authorize-net.ts # Authorize.net の統合実装
│   └── mcp-server.ts    # MCP サーバーの主要なロジック
├── package.json         # プロジェクトの依存関係とスクリプト設定
└── README.md            # プロジェクトドキュメント

注意事項

• セキュリティに関する注意：実際の API キーをコードリポジトリにコミットしないでください。環境変数または専用のキー管理ツールを使用することをおすすめします。
• 本番環境：本番環境でのデプロイ時には、通信を保護するために HTTPS またはその他のセキュリティプロトコルを使用することを確認してください。

関連リンク

• MCP TypeScript SDK (GitHub)
• Authorize.net 開発者ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、プロジェクトの LICENSE ファイルを参照してください。