Bitrefill MCP Server

Bitrefill MCP Server

site icon
2025.03.31 3
TypeScript礼品卡服务手机充值服务电子支付金融服务
Bitrefill MCP Server 是一个基于 TypeScript 的 MCP 服务器,提供对 Bitrefill 服务的访问,允许用户搜索礼品卡、手机充值等服务。该服务器实现了模型上下文协议(MCP),将 Bitrefill 的功能暴露给 AI 助手。
View on GitHub

Overview

基本能力

产品定位

Bitrefill MCP Server 是一个连接 Bitrefill 服务的中间件,通过 MCP 协议为 AI 助手提供访问 Bitrefill 服务的接口。

核心功能

  • 提供 Bitrefill 服务的搜索功能(礼品卡、eSIMs、手机充值等)
  • 获取产品详细信息
  • 创建和管理发票
  • 获取订单信息
  • 账户余额查询
  • Bitrefill API 可用性检查

适用场景

  • AI 助手集成 Bitrefill 服务
  • 自动化礼品卡购买流程
  • 手机充值自动化
  • 电子礼品卡管理

工具列表

  1. search - 搜索礼品卡、eSIMs、手机充值等
  2. detail - 获取产品详细信息
  3. categories - 获取产品类型/类别映射
  4. create_invoice - 创建新发票
  5. get_invoices - 获取发票列表
  6. get_invoice - 获取特定发票详情
  7. pay_invoice - 支付未付发票
  8. get_orders - 获取订单列表
  9. get_order - 获取特定订单详情
  10. unseal_order - 显示订单代码和PIN
  11. get_account_balance - 获取账户余额
  12. ping - 检查API可用性

常见问题解答

  • 需要使用 API 密钥才能使用除搜索、类别和详情外的所有工具
  • 调试建议使用 MCP Inspector
  • 可以通过多种方式安装(Smithery、Claude Desktop、Cline、Cursor、Docker)

使用教程

使用依赖

  1. 安装 Node.js 环境
  2. 创建 Bitrefill 账户并申请开发者 API 密钥

安装教程

  1. 克隆项目
  2. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发模式(自动重建):
npm run watch

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

其他安装方式

  1. 通过 Smithery 安装:
npx -y @smithery/cli install @bitrefill/bitrefill-mcp-server --client claude
  1. Docker 安装:
docker build -t bitrefill-mcp-server .
docker run -e BITREFILL_API_SECRET=your_api_key_here -e BITREFILL_API_ID=your_api_id_here bitrefill-mcp-server

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。