Bitrefill MCP Server

🚀 BitRefill MCP 服務器

BitRefill MCP 服務器是基於 TypeScript 的最小可行產品（MCP）服務器，藉助 Model Context Protocol 提供 BitRefill 服務。它能實現禮品卡與電子貨幣搜索、手機充值等功能，為用戶使用比特幣購買禮品卡和充值手機提供便利。

🚀 快速開始

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

1. 註冊工具：服務器啟動時向 MCP 註冊可用工具。
2. 處理請求：收到工具請求，執行相應操作。
3. 返回響應：以結構化的 JSON 格式返回結果。
4. 錯誤處理：若發生錯誤，返回包含錯誤信息的 JSON 響應。

由於服務器通過標準輸入輸出 (stdio) 進行通信，可使用任何支持 MCP 的工具進行調試。

✨ 主要特性

• 搜索禮品卡和電子貨幣。
• 手機充值。
• 其他相關服務。

📦 安裝指南

使用 npm 安裝

1. 克隆倉庫：

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

2. 安裝依賴：

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     # 項目依賴和配置