项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,它集成 Skyfire 支付系统,为 AI 模型提供支付能力。通过此服务器,AI 模型可以调用预设的工具,安全便捷地完成支付操作。

主要功能点

  • 'make_payment' 工具: 允许 AI 模型向指定的 Skyfire 用户发起支付。
    • 接收 'receiverUsername' (收款人用户名) 和 'amount' (支付金额) 两个参数。
    • 调用 Skyfire SDK 完成支付,并返回支付成功的消息。
    • 具备完善的错误处理机制,能够应对无效工具名、参数错误以及支付失败等情况。
  • MCP 协议支持: 遵循 MCP 协议标准,能够与任何兼容 MCP 协议的客户端进行通信。
  • Stdio 传输: 使用标准输入/输出 (stdio) 作为传输协议,易于集成和部署。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/MCP-Mirror/0xtotaylor_mcp-server-skyfire
    cd 0xtotaylor_mcp-server-skyfire
  2. 安装依赖:

    npm install
  3. 配置环境变量: 在项目根目录下创建 '.env' 文件,并填入你的 Skyfire API Key。

    SKYFIRE_API_KEY=your_api_key_here

    请务必替换 'your_api_key_here' 为你真实的 Skyfire API Key。

  4. 构建项目:

    npm run build

    构建成功后,可执行文件将位于 './build/index.js'。

服务器配置

以下 JSON 配置信息用于 MCP 客户端连接此服务器。

{
  "serverName": "mcp-server-skyfire",
  "command": "./build/index.js",
  "args": []
}
  • 'serverName': 服务器名称,可以自定义。
  • 'command': 服务器启动命令。 指向构建后的服务器可执行文件。请确保路径正确,相对于 MCP 客户端的工作目录。
  • 'args': 启动参数列表。 此服务器不需要额外的启动参数,因此为空数组。

注意: 请确保 MCP 客户端能够执行 './build/index.js' 文件。如果客户端和服务器部署在不同环境中,请根据实际情况调整 'command' 路径。

基本使用方法

  1. 启动 MCP 服务器: 在服务器端,确保已完成安装和构建步骤。当 MCP 客户端尝试连接时,服务器将通过 stdio 自动启动。你也可以手动运行 './build/index.js' 来启动服务器。

  2. 配置 MCP 客户端: 在 MCP 客户端中,配置上述提供的服务器配置信息。客户端将使用该配置连接到 MCP 服务器。

  3. 调用 'make_payment' 工具: 在 AI 模型或 MCP 客户端中,可以调用 'make_payment' 工具发起支付。你需要提供 'receiverUsername' 和 'amount' 两个参数。例如,使用 JSON-RPC 请求调用工具可能如下所示 (示例,具体取决于你的 MCP 客户端实现):

    {
      "jsonrpc": "2.0",
      "method": "call_tool",
      "params": {
        "name": "make_payment",
        "arguments": {
          "receiverUsername": "recipient_username",
          "amount": "10.00"
        }
      },
      "id": 1
    }

    服务器将处理该请求,调用 Skyfire SDK 完成支付,并返回包含支付结果的 JSON-RPC 响应。

请参考 MCP 客户端的文档,了解如何配置和使用 MCP 服务器以及如何调用工具。

信息

分类

商业系统