Authorize Net MCP

🚀 authorize-net-mcp 項目文檔

本項目是基於 Model Context Protocol (MCP) 的服務器項目，整合了 Authorize.net Node SDK，提供兩種主要支付功能，可滿足不同場景下的支付需求。

🚀 快速開始

安裝依賴

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

✨ 主要特性

• 立即扣款 (takePayment)：支持直接從客戶的信用卡中扣除指定金額。
• 生成賬單 (createInvoice)：創建一個託管頁面鏈接，客戶可以通過該鏈接輸入支付信息完成交易。

📋 模型上下文協議 (MCP) 簡介

MCP 是一種用於連接模型和上下文數據的協議，允許在不同的環境中進行交互。通過 MCP，可以方便地調用各種工具和服務。

📦 項目結構

project/
├── src/                 # 源代碼目錄
│   ├── authorize-net.ts # Authorize.net 的集成實現
│   └── mcp-server.ts    # MCP 服務器的主要邏輯
├── package.json         # 項目依賴和腳本配置
└── README.md            # 項目文檔

💻 使用示例

列出可用工具

調用以下命令以獲取所有可用的 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"
}

📚 注意事項

⚠️ 重要提示

切勿將真實的 API 密鑰提交到代碼倉庫，建議使用環境變量或專業的密鑰管理工具。

⚠️ 重要提示

正式部署時，請確保使用 HTTPS 或其他安全協議來保護通信。

📚 進一步閱讀

• MCP TypeScript SDK (GitHub)
• Authorize.net 開發文檔

📄 許可證

本項目採用 MIT 許可證。更多細節請參考項目的 LICENSE 文件。