MCP 服务器

Bitrefill Search and Shop
官方

这个 MCP 封装了 Bitrefill 的公共 API，允许代理使用比特币、以太坊、Solana 等加密货币搜索产品和购物。

电子商务与零售

金融

访问服务器

README

Bitrefill MCP 服务器

一个基于 TypeScript 的 MCP 服务器，提供对 Bitrefill 服务的访问，允许您搜索礼品卡、手机充值等。此服务器实现了模型上下文协议，以向 AI 助手公开 Bitrefill 功能。

工作原理

该服务器使用模型上下文协议 (MCP) 与 Claude 和类似的 AI 助手进行通信。它：

作为使用 stdio 进行通信的独立进程运行
注册用于访问 Bitrefill 服务的资源和工具
与 Bitrefill API 交互以提供产品搜索和详细信息
返回可由 AI 助手处理的结构化 JSON 响应

架构

应用服务器遵循以下架构：

src/
├── index.ts                # 主要入口点
├── constants/              # 静态数据
│   ├── categories.ts       # 产品类别
│   └── payment_methods.ts  # 支付方式
├── handlers/               # MCP 请求处理程序
│   ├── resources.ts        # 资源端点
│   └── tools.ts            # 工具实现
├── schemas/               # 数据验证模式
│   ├── detail.ts           # 产品详细信息响应类型
│   ├── invoice.ts          # 发票模式
│   ├── misc.ts            # 杂项模式
│   ├── order.ts            # 订单模式
│   └── search.ts           # 搜索参数和响应类型
├── services/              # API 服务
│   ├── invoices.ts         # 发票服务
│   ├── misc.ts            # 杂项服务
│   ├── orders.ts           # 订单服务
│   ├── products.ts         # 产品详细信息服务
│   └── search.ts           # 搜索功能
└── utils/                 # 实用函数
    ├── index.ts            # 错误日志记录等
    └── api/                # API 客户端
        ├── authenticated.ts # 经过身份验证的 API 客户端
        ├── base.ts         # 基本 API 客户端
        └── public.ts       # 公共 API 客户端

特性

资源

bitrefill://product-types - Bitrefill 上可用的产品类型列表
bitrefill://categories/{type} - 特定产品类型的可用类别列表（例如，bitrefill://categories/gift-cards）

工具

search - 搜索礼品卡、esim、手机充值等
- 必需：query（例如，“Amazon”、“Netflix”、“AT&T”或“*”表示全部）
- 可选：country、language、limit、skip、category
detail - 获取有关产品的详细信息
- 必需：id（产品标识符）
categories - 获取完整的产品类型/类别映射
- 无需参数
create_invoice - 创建用于购买产品的新发票（需要 API 密钥）
- 必需：products（要包含在发票中的产品数组）
  - 每个产品都需要：product_id
  - 可选产品字段：quantity、value、package_id、phone_number、email、send_email、send_sms
- 必需：payment_method（以下之一：“balance”、“bitcoin”、“lightning”）
- 可选：webhook_url、auto_pay
get_invoices - 检索发票列表，并可选择进行过滤
- 可选：start、limit、after、before
get_invoice - 按 ID 检索特定发票的详细信息
- 必需：id（发票标识符）
pay_invoice - 支付未付发票（仅适用于“balance”支付方式）
- 必需：id（发票标识符）
get_orders - 检索订单列表，并可选择进行过滤
- 可选：start、limit、after、before
get_order - 按 ID 检索特定订单的详细信息
- 必需：id（订单标识符）
unseal_order - 显示特定订单的 ID 的代码和 PIN
- 必需：id（订单标识符）
get_account_balance - 检索您的帐户余额
- 无需参数
ping - 检查 Bitrefill API 是否可用
- 无需参数

配置

API 密钥设置

要使用所有依赖于 Bitrefill API 的工具（除了 search、categories 和 detail），您需要设置 Bitrefill API 凭据：

创建一个 Bitrefill 帐户
通过在此表单上提交请求来申请开发者 API 密钥 this form
在根目录中创建一个 .env 文件（您可以从 .env.example 复制）

添加您的 Bitrefill API 凭据：

BITREFILL_API_SECRET=your_api_key_here
BITREFILL_API_ID=your_api_id_here

仅当设置了 API 凭据时，create_invoice 工具才可用。如果未设置 API 凭据，则该工具将不会注册，也不会出现在可用工具列表中。

开发

安装依赖项：

npm install

构建服务器：

npm run build

对于具有自动重建功能的开发：

npm run watch

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Bitrefill：

npx -y @smithery/cli install @bitrefill/bitrefill-mcp-server --client claude

Claude Desktop

在以下位置添加服务器配置：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bitrefill": {
      "command": "npx",
      "args": ["-y", "bitrefill-mcp-server"],
      "env": {
        "BITREFILL_API_SECRET": "your_api_key_here",
        "BITREFILL_API_ID": "your_api_id_here"
      }
    }
  }
}

Cline

打开 Cline 扩展设置
打开“MCP 服务器”选项卡
单击“配置 MCP 服务器”
添加服务器配置：

{
  "mcpServers": {
    "github.com/bitrefill/bitrefill-mcp-server": {
      "command": "npx",
      "args": ["-y", "bitrefill-mcp-server"],
      "disabled": false,
      "autoApprove": ["search", "detail", "categories"],
      "env": {
        "BITREFILL_API_ID": "your_api_id_here",
        "BITREFILL_API_SECRET": "your_api_key_here"
      }
    }
  }
}

其他 Cline 配置选项：

disabled：设置为 false 以启用服务器
autoApprove：不需要每次使用都显式批准的工具列表

Cursor

打开 Cursor 设置
打开“功能”设置
在“MCP 服务器”部分中，单击“添加新的 MCP 服务器”
选择一个名称，然后选择“command”作为“类型”
在“命令”字段中，输入以下内容：

npx -y bitrefill-mcp-server

（可选）如果您使用的是 create_invoice 工具，请添加环境变量：
- BITREFILL_API_SECRET: your_api_key_here
- BITREFILL_API_ID: your_api_id_here

Docker

您还可以使用 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

对于开发，您可能想要将源代码挂载为卷：

docker run -v $(pwd):/app --env-file .env bitrefill-mcp-server

推荐服务器

Crypto Price & Market Analysis MCP Server

一个模型上下文协议 (MCP) 服务器，它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器，利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面，提供实时价格数据、市场分析以及历史趋势数据。

精选

TypeScript