JinDaGe - bitrefill-mcp-server MCP Details

article

README

🚀 BitRefill MCP 服务器

BitRefill MCP 服务器是基于 TypeScript 的最小可行产品（MCP）服务器，借助 Model Context Protocol 提供 BitRefill 服务。它能实现礼品卡与电子货币搜索、手机充值等功能，为用户使用比特币购买礼品卡和充值手机提供便利。

🚀 快速开始

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

注册工具：服务器启动时向 MCP 注册可用工具。
处理请求：收到工具请求，执行相应操作。
返回响应：以结构化的 JSON 格式返回结果。
错误处理：若发生错误，返回包含错误信息的 JSON 响应。

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

✨ 主要特性

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

📦 安装指南

使用 npm 安装

克隆仓库：

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

安装依赖：

npm install

使用 Smithery 安装

要通过 Smithery 自动安装 BitRefill：

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

使用 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

💻 使用示例

配置

在根目录下创建一个 .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，用于在浏览器中访问调试工具。

在不同环境中使用

在 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"
      }
    }
  }
}

📚 详细文档

目录结构

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

bitrefill-mcp-server