
Bitrefill MCP Server

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 服务
- 自动化礼品卡购买流程
- 手机充值自动化
- 电子礼品卡管理
工具列表
search
- 搜索礼品卡、eSIMs、手机充值等detail
- 获取产品详细信息categories
- 获取产品类型/类别映射create_invoice
- 创建新发票get_invoices
- 获取发票列表get_invoice
- 获取特定发票详情pay_invoice
- 支付未付发票get_orders
- 获取订单列表get_order
- 获取特定订单详情unseal_order
- 显示订单代码和PINget_account_balance
- 获取账户余额ping
- 检查API可用性
常见问题解答
- 需要使用 API 密钥才能使用除搜索、类别和详情外的所有工具
- 调试建议使用 MCP Inspector
- 可以通过多种方式安装(Smithery、Claude Desktop、Cline、Cursor、Docker)
使用教程
使用依赖
- 安装 Node.js 环境
- 创建 Bitrefill 账户并申请开发者 API 密钥
安装教程
- 克隆项目
- 安装依赖:
npm install
- 构建服务器:
npm run build
- 开发模式(自动重建):
npm run watch
调试方式
使用 MCP Inspector 进行调试:
npm run inspector
其他安装方式
- 通过 Smithery 安装:
npx -y @smithery/cli install @bitrefill/bitrefill-mcp-server --client claude
- 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