BitRefill MCP 服务器

简介

BitRefill MCP 服务器是一个基于 TypeScript 的最小可行产品 (MCP) 服务器，用于通过 Model Context Protocol 提供 BitRefill 服务。该服务器提供以下功能：

• 搜索礼品卡和电子货币
• 手机充值
• 其他相关服务

BitRefill 是一个允许用户使用比特币购买礼品卡和充值手机的平台。

如何工作

BitRefill MCP 服务器通过 Model Context Protocol (MCP) 提供工具，使 AI 助手（如 Claude）能够调用 BitRefill 的功能。以下是服务器的工作流程：

1. 注册工具：服务器启动时会向 MCP 注册可用工具。
2. 处理请求：当收到一个工具请求时，服务器会执行相应的操作。
3. 返回响应：服务器会以结构化的格式（JSON）返回结果。
4. 错误处理：如果发生错误，服务器会返回包含错误信息的 JSON 响应。

MCP 通信

由于 BitRefill MCP 服务器通过标准输入输出 (stdio) 进行通信，因此可以使用任何支持 MCP 的工具进行调试。

目录结构

bitrefill-mcp-server/
├── src/             # 源代码
│   ├── server.ts    # 主服务器文件
│   └── tools/       # 可用工具
└── package.json     # 项目依赖和配置

安装

使用 npm 安装

1. 克隆仓库：

   git clone https://github.com/bitrefill/bitrefill-mcp-server.git
   cd bitrefill-mcp-server
   

2. 安装依赖：

   npm install
   

配置

在根目录下创建一个 .env 文件（可参考 .env.example），并添加以下内容：

BITREFILL_API_SECRET=your_api_key_here
BITREFILL_API_ID=your_api_id_here

可用工具

• search: 搜索可用的礼品卡和电子货币。
• invoice: 创建一个发票请求（需要 API 凭证）。

注意：如果没有设置 API 凭证，create_invoice 工具将不可用，并且不会注册到 MCP 服务器中。

开发

构建

npm run build

监控开发

npm run watch

调试

由于 BitRefill MCP 服务器通过 stdio 进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL，用于在浏览器中访问调试工具。

安装指南

使用 Smithery 安装

要通过 Smithery 自动安装 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": ["@smithery/cli", "start"],
      "env": {
        "BITREFILL_API_SECRET": "your_api_key_here",
        "BITREFILL_API_ID": "your_api_id_here"
      }
    }
  }
}

在 Cline 中使用

在 ~/.config/eline/mcp-config.json 文件中添加以下内容：

{
  "servers": {
    "bitrefill": {
      "command": "npx",
      "args": ["@smithery/cli", "start"],
      "env": {
        "BITREFILL_API_SECRET": "your_api_key_here",
        "BITREFILL_API_ID": "your_api_id_here"
      }
    }
  }
}

在 Cursor 中使用

在 config/cursor.mcp.json 文件中添加以下内容：

{
  "servers": {
    "bitrefill": {
      "command": "npx",
      "args": ["@smithery/cli", "start"],
      "env": {
        "BITREFILL_API_SECRET": "your_api_key_here",
        "BITREFILL_API_ID": "your_api_id_here"
      }
    }
  }
}

使用 Docker

docker build -t bitrefill-mcp-server .
docker run -it --rm -e BITREFILL_API_SECRET=your_api_key_here -e BITREFILL_API_ID=your_api_id_here bitrefill-mcp-server