支付链接管理服务

一个用于Global Payments API集成的模型上下文协议(MCP)服务器,支持通过TypeScript/Node.js编程方式创建和管理支付链接。

  • by globalpayments
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 globalpayments/mcp-server

使用说明

全球支付MCP服务器(TypeScript)

用于全球支付API集成的模型上下文协议(MCP)服务器,使人工智能代理能够使用TypeScript/Node.js以编程方式创建和管理支付链接。

目录

关于

该MCP服务器将人工智能代理(如Claude或GitHub Copilot)与全球支付API连接起来,允许通过自动身份验证、令牌管理和全面的错误处理创建、检索和管理自然语言支付链接。使用TypeScript构建,用于类型安全和现代Node.js开发。

特性

  • 支付链接创建(一次性和多用途)
  • 支付链接检索和过滤
  • API文档检索(19个以上API类别)

先决条件

  • Node.js 18.0或更高版本

  • npm

  • 全球支付API凭证(把他们带到这儿来)

  • Claude Desktop、带有Copilot的VS Code或其他兼容MCP的客户端

    注: 建议正在使用的应用程序具有有限的访问权限。具体来说,在应用程序权限中只应添加与LNK相关的资源

安装

  1. 克隆仓库

    git clone https://github.com/globalpayments/mcp-server.git
    cd gpapi-mcp-server/Typescript
    
  2. 安装依赖项

    npm install
    
  3. 构建项目

    npm run build
    
  4. 创建 .env 项目根目录中的文件

    创建一个 .env TypeScript目录中的文件,其中包含您的凭据:

    # Required: Your Global Payments App credentials (format: APP_ID:APP_SECRET)
    GPAPI_APP=your_app_id:your_app_secret
    
    # Optional: Your Global Payments Account (provide ONE of these, or leave blank for auto-detection)
    # If not provided, the account will be auto-detected from the access token
    # GPAPI_ACCOUNT_ID=your_account_id
    # OR
    # GPAPI_ACCOUNT_NAME=your_account_name
    
    # Optional: Environment (SANDBOX, or PROD, default: SANDBOX)
    ENV=SANDBOX
    

    注: 这 .env 文件是存储凭据的推荐方式。它使敏感信息远离配置文件,并使管理不同的环境变得更加容易。

  5. 配置您的MCP客户端

    适用于克劳德桌面

    添加到您的 claude_desktop_config.json:

    {
      "mcpServers": {
        "global-payments": {
          "command": "node",
          "args": [
            "X://absolute//path//to//gpapi-mcp-server//Typescript//lib//index.js"
          ],
          "env":{
           "GPAPI_APP":"XXXXXXXXXXXXXXXXX:XXXXXXX",
           "GPAPI_ACCOUNT_NAME":"XXXXXXXXX",
           "ENV":"SANDBOX"
          }
        }
      }
    }
    

    VS代码(副本)

    添加到您的VS Code MCP设置文件(mcp.json):

    {
      "servers": {
        "global-payments": {
          "command": "node",
          "args": [
            "lib/index.js"
          ],
          "cwd": "./",
          "env":{
           "GPAPI_APP":"XXXXXXXXXXXXXXXXX:XXXXXXX",
           "GPAPI_ACCOUNT_NAME":"XXXXXXXXX",
           "ENV":"SANDBOX"
          }
        }
      }
    }
    

    注: 确保在以下位置提供TypeScript项目目录的绝对路径 cwd 现场。这 .env 文件应位于此目录中。

可用工具

此MCP服务器提供以下工具:

工具 说明
create_payment_link 创建一次性或多用途支付链接
get_links 检索和过滤付款链接
get_documentation 检索19个以上类别的API文档