项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,它集成 Skyfire 支付系统,为 AI 模型提供支付能力。通过此服务器,AI 模型可以调用预设的工具,安全便捷地完成支付操作。
主要功能点
- 'make_payment' 工具: 允许 AI 模型向指定的 Skyfire 用户发起支付。
- 接收 'receiverUsername' (收款人用户名) 和 'amount' (支付金额) 两个参数。
- 调用 Skyfire SDK 完成支付,并返回支付成功的消息。
- 具备完善的错误处理机制,能够应对无效工具名、参数错误以及支付失败等情况。
- MCP 协议支持: 遵循 MCP 协议标准,能够与任何兼容 MCP 协议的客户端进行通信。
- Stdio 传输: 使用标准输入/输出 (stdio) 作为传输协议,易于集成和部署。
安装步骤
-
克隆仓库:
git clone https://github.com/MCP-Mirror/0xtotaylor_mcp-server-skyfire cd 0xtotaylor_mcp-server-skyfire -
安装依赖:
npm install -
配置环境变量: 在项目根目录下创建 '.env' 文件,并填入你的 Skyfire API Key。
SKYFIRE_API_KEY=your_api_key_here请务必替换 'your_api_key_here' 为你真实的 Skyfire API Key。
-
构建项目:
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' 路径。
基本使用方法
-
启动 MCP 服务器: 在服务器端,确保已完成安装和构建步骤。当 MCP 客户端尝试连接时,服务器将通过 stdio 自动启动。你也可以手动运行 './build/index.js' 来启动服务器。
-
配置 MCP 客户端: 在 MCP 客户端中,配置上述提供的服务器配置信息。客户端将使用该配置连接到 MCP 服务器。
-
调用 '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 服务器以及如何调用工具。
信息
分类
商业系统