MCP 服务器

authorize-net-mcp

实验性的 Authorize.net Node.js TypeScript MCP 服务器

zmarty

开发者工具

访问服务器

README

authorize-net-mcp

本项目是一个 模型上下文协议 (MCP) 服务器，它与 Authorize.net Node SDK 集成，提供两个主要的支付操作：

takePayment – 立即收取信用卡费用 (AUTH_CAPTURE)。
createInvoice – 生成一个托管支付页面（发票），供客户在线支付。

通过将这些操作公开为 MCP 工具，使用 MCP Node SDK 的 AI 代理和其他平台可以无缝调用 Authorize.net 功能，而无需直接处理信用卡或交易逻辑。

什么是模型上下文协议 (MCP)？

模型上下文协议 (MCP) 是一种规范和软件开发工具包 (SDK)，它标准化了 AI 模型（例如，大型语言模型）与外部工具和服务通信的方式。 MCP 服务器提供 AI 助手或自动化平台可以以编程方式发现和调用的“工具”（方法）。 MCP 的目标包括：

可发现性：工具会公布其功能和输入/输出模式。
标准化 I/O：AI 模型或任何客户端都可以使用基于 JSON 的模式调用工具，并接收结构化输出，从而使自动化工作流程更加可靠。
安全性与兼容性：工具在隔离的进程中运行，并通过定义明确的通道（例如，stdio）进行通信，这有助于将它们与 AI 模型环境隔离。

在这个项目中，takePayment 和 createInvoice 方法被定义为 MCP 工具，具有输入模式（金额、卡详细信息、发票信息）和结构化的 JSON 输出。这意味着任何实现 MCP 协议的 AI 模型或系统都可以查询此服务器以了解可用工具，然后使用正确的参数调用它们以通过 Authorize.net 处理付款。

工作原理

MCP Node SDK – 提供在 Node.js 中创建和运行 MCP 服务器的框架。我们使用 Server、StdioServerTransport 等类和模式定义（ListToolsRequestSchema、CallToolRequestSchema）来注册工具并通过 stdio 响应请求。
Authorize.net Node SDK – 管理底层支付交易调用。在我们的 MCP 工具处理程序中，我们导入 authorizenet 包，并使用您的 Authorize.net 凭据构建请求（例如，CreateTransactionRequest）。
MCP 工具 –
- takePayment: 接受信用卡号、到期日期、CVV 和金额，然后立即向卡收费。
- createInvoice: 准备一个没有卡数据的交易（卡数据通过托管的 Authorize.net 表单收集），并返回一个 URL，客户可以被定向到该 URL 以安全地支付发票。

当服务器启动时，它会将这两个工具（及其输入模式）公布给任何连接的 MCP 客户端。然后，客户端可以根据需要调用它们。

项目结构

authorize-net-mcp/
├── package.json
├── tsconfig.json
├── src
│   ├── index.ts               # MCP 服务器初始化
│   ├── models
│   │   └── authorizeNetModel.ts   # JSON 模式和工具规范
│   └── handlers
│       └── authorizeNetHandlers.ts # takePayment 和 createInvoice 的实现
└── README.md

src/index.ts: 创建一个 MCP Server，注册工具处理程序，并通过 stdio 监听请求。
src/models/authorizeNetModel.ts: 以 JSON 模式格式定义两个工具的输入/输出模式（当 MCP 客户端调用 ListTools 时会公布）。
src/handlers/authorizeNetHandlers.ts: 包含与 Authorize.net 集成的核心逻辑（信用卡收费、创建托管发票）。

入门指南

1. 安装

克隆或下载此存储库。
安装依赖项：
```
npm install
```

2. 设置环境变量

您必须提供您的 Authorize.net API 凭据。对于测试，您可以使用 Authorize.net 沙箱凭据。服务器将查找：

AUTHORIZE_NET_API_LOGIN_ID
AUTHORIZE_NET_TRANSACTION_KEY

在构建或启动服务器之前设置它们：

对于 Linux/Mac：

export AUTHORIZE_NET_API_LOGIN_ID="YOUR_SANDBOX_LOGIN_ID"
export AUTHORIZE_NET_TRANSACTION_KEY="YOUR_SANDBOX_TRANSACTION_KEY"

对于 Windows (命令提示符)：

set AUTHORIZE_NET_API_LOGIN_ID=YOUR_SANDBOX_LOGIN_ID
set AUTHORIZE_NET_TRANSACTION_KEY=YOUR_SANDBOX_TRANSACTION_KEY

对于 Windows (PowerShell)：

$env:AUTHORIZE_NET_API_LOGIN_ID="YOUR_SANDBOX_LOGIN_ID"
$env:AUTHORIZE_NET_TRANSACTION_KEY="YOUR_SANDBOX_TRANSACTION_KEY"

3. 构建并运行

# 构建 TypeScript
npm run build

# 启动 MCP 服务器（监听 stdio）
npm start

服务器将运行并等待 MCP 请求。通常，理解 MCP 的 AI 助手或自动化工具将生成或连接到此进程，并按名称调用 takePayment 或 createInvoice 工具。

使用 MCP 工具

在 MCP 兼容的环境中（例如，支持 MCP 的 AI 聊天），工作流程可能是：

列出可用工具（服务器返回 [takePayment, createInvoice] 及其模式）。
调用 takePayment 工具，并带有参数：
```
{
  "amount": 19.99,
  "cardNumber": "4242424242424242",
  "expirationDate": "0825",
  "cardCode": "123"
}
```
- 服务器返回支付是否成功，并在响应消息中包含交易详细信息。
调用 createInvoice 工具，并带有参数：
```
{
  "amount": 50.0,
  "invoiceNumber": "INV-1001",
  "description": "T-shirt order"
}
```
- 服务器响应一个托管支付页面的 URL。将客户定向到该链接以安全地输入卡详细信息。