使用说明

项目简介

Fewsats MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端,旨在为AI Agent提供与 Fewsats 平台安全交互的能力。通过此服务器,AI Agent可以查询账户余额、获取支付方式、发起支付以及查询支付信息,从而实现自动化购买等功能。

主要功能点

  • 查询余额 (balance): 允许AI Agent获取Fewsats账户的钱包余额。
  • 获取支付方式 (payment_methods): 允许AI Agent获取用户可用的支付方式列表。
  • 支付订单 (pay_offer): 允许AI Agent使用指定的offer_id和详细的订单信息,在Fewsats平台完成支付。
  • 查询支付信息 (payment_info): 允许AI Agent根据支付ID查询具体的支付状态和详细信息。

安装步骤

  1. 使用pip安装 (推荐): 打开终端,运行以下命令安装 'fewsats-mcp':
    pip install fewsats-mcp
    安装完成后,'fewsats-mcp' 即可作为MCP服务器运行。

服务器配置

此MCP服务器主要与 MCP 客户端(例如 Claude Desktop)配合使用。你需要在 MCP 客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 的 'claude_desktop_config.json' 配置文件示例,你需要将此配置添加到你的客户端配置中。

重要: 请将 'YOUR_FEWSATS_API_KEY' 替换为你从 Fewsats.com 获取的API密钥。

"mcpServers": {
  "Fewsats Server": {
    "command": "fewsats-mcp",
    "args": [],
    "env": {
      "FEWSATS_API_KEY": "YOUR_FEWSATS_API_KEY"
    }
  }
}

配置参数说明:

  • '"Fewsats Server"': 服务器名称,可以自定义,用于在MCP客户端中标识该服务器。
  • '"command": "fewsats-mcp"': 启动服务器的命令。安装 'fewsats-mcp' 后,可以直接使用 'fewsats-mcp' 命令启动服务器。
  • '"args": []': 传递给启动命令的参数,此服务器无需额外参数,因此为空数组。
  • '"env": { "FEWSATS_API_KEY": "YOUR_FEWSATS_API_KEY" }': 设置环境变量。'FEWSATS_API_KEY' 是 Fewsats API 的密钥,必须替换 为你自己的API密钥,用于服务器与 Fewsats 平台的身份验证。

基本使用方法

  1. 配置MCP客户端: 按照上述服务器配置信息,将 Fewsats MCP 服务器添加到你的 MCP 客户端配置中。确保正确填写 Fewsats API 密钥。
  2. 启动MCP客户端: 启动你的 MCP 客户端(例如 Claude Desktop)。客户端会自动连接并管理 Fewsats MCP 服务器。
  3. 在AI Agent中使用工具: 在支持 MCP 协议的 AI Agent 中,你可以调用 Fewsats MCP 服务器提供的工具(例如 'balance', 'pay_offer' 等)来与 Fewsats 平台进行交互。具体的工具调用方式取决于你的 AI Agent 平台的接口和文档。

注意: 此服务器需要在运行环境中配置 'FEWSATS_API_KEY' 环境变量才能正常工作,请务必在 MCP 客户端的配置中正确设置。

信息

分类

商业系统