项目简介

FIB支付MCP服务器是一个轻量级的Model Context Protocol (MCP) 服务器，旨在将First Iraqi Bank (FIB) 的在线支付API功能以标准化的方式提供给大型语言模型 (LLM) 应用。通过此服务器，LLM应用可以安全、便捷地调用FIB银行的支付服务，实现智能化的支付处理流程。

主要功能点

支付工具集成: 将创建支付、查询支付状态、取消支付和退款等支付操作封装为可供LLM调用的工具 (Tools)。
API桥梁: 作为LLM应用和FIB银行支付API之间的桥梁，简化API调用流程，提供统一的MCP接口。
环境配置: 支持通过环境变量配置FIB API的连接参数和身份验证信息。
客户端兼容: 兼容实现了MCP协议的客户端，例如 Claude Desktop App 等。

安装步骤

安装 Java 21: 确保您的系统已安装 Java 21 或更高版本。您可以从 Oracle官网下载并安装。
下载或构建 JAR 文件: 从仓库 Releases 页面下载预编译的 JAR 文件 'fib-pay-mcp-0.0.1.jar'，或者克隆仓库代码后自行使用 Maven 构建。
配置 MCP 客户端: 以 Claude Desktop App 为例，打开 Claude 应用的设置，进入开发者选项，编辑配置文件 'claude_desktop_config.json'。

服务器配置 (MCP 客户端配置)

在 MCP 客户端的配置文件中 (例如 'claude_desktop_config.json')，添加或修改 'mcpServers' 部分，配置 FIB支付MCP服务器的启动信息。以下是 Claude Desktop App 的配置示例：

{
  "mcpServers": {
    "fib-pay-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "fib-pay-mcp-0.0.1.jar"
      ],
      "env": {
        "FIB_URL": "YOUR_FIB_URL",  // 替换为您的 FIB API URL
        "FIB_CLIENT_SECRET": "YOUR_CLIENT_SECRET", // 替换为您的 FIB API 客户端密钥
        "FIB_CLIENT_ID": "YOUR_CLIENT_ID" // 替换为您的 FIB API 客户端 ID
      }
    }
  }
}

配置参数说明:

'command': 启动服务器的命令，这里使用 'java'，确保 Java 可执行文件已添加到系统 PATH 环境变量中。如果 'java' 不在 PATH 中，需要使用 Java 可执行文件的完整路径，例如 '"C:\Program Files\Java\jdk-21\bin\java.exe"' (Windows) 或 '"/usr/bin/java"' (Linux/macOS)。
'args': 传递给 'java' 命令的参数，'-jar fib-pay-mcp-0.0.1.jar' 表示运行 JAR 文件。如果 JAR 文件不在当前工作目录，请提供 JAR 文件的完整路径，例如 '"/path/to/fib-pay-mcp-0.0.1.jar"'。
'env': 设置环境变量，用于配置 FIB API 的连接信息和身份验证凭据。
- 'FIB_URL': FIB API 的基础 URL。
- 'FIB_CLIENT_SECRET': FIB API 客户端密钥。
- 'FIB_CLIENT_ID': FIB API 客户端 ID。

注意: 您也可以选择在系统环境变量中预先设置 'FIB_URL', 'FIB_CLIENT_SECRET', 'FIB_CLIENT_ID'，然后在 'claude_desktop_config.json' 中省略 'env' 块。

基本使用方法

启动 FIB支付MCP服务器 (通过 MCP 客户端启动或手动运行 JAR 文件)。
在支持 MCP 协议的 LLM 应用中，配置并连接到 FIB支付MCP服务器。
LLM 应用可以通过工具调用 (Tool Call) 的方式，使用服务器提供的支付工具，例如 'payment' (创建支付), 'checkPayment' (查询支付状态) 等，具体工具名称和参数请参考代码中的 '@Tool' 注解。
LLM 应用根据工具的描述和参数，构建合适的请求，并调用相应的工具来完成支付相关操作。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP 客户端配置)

基本使用方法

信息