Bitrefill Bitrefill MCP Server

🚀 Bitrefill MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，它提供了對 Bitrefill 服務的訪問權限，允許您搜索禮品卡、進行手機充值等操作。該服務器實現了模型上下文協議（Model Context Protocol），能夠向 AI 助手暴露 Bitrefill 的各項功能。

🚀 快速開始

該服務器使用 Model Context Protocol (MCP) 與 AI 助手通信。以下是其工作流程：

安裝依賴項

npm install

構建服務器

npm run build

開發模式（自動重建）

npm run watch

調試

使用 MCP 監視器進行調試，命令如下：

npm run inspector

該工具將提供一個瀏覽器 URL，用於訪問調試工具。

📦 安裝指南

通過 Smithery 安裝

自動安裝 Bitrefill 到 Claude Desktop：

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 中配置

1. 打開 Cline 設置。
2. 進入“MCP 服務器”選項卡。
3. 點擊“配置 MCP 服務器”。
4. 添加以下配置：

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

在 Cursor 中配置

1. 打開 Cursor 設置。
2. 進入“功能”設置。
3. 在“MCP 服務器”部分，點擊“添加新 MCP 服務器”。
4. 輸入名稱並選擇類型為“command”。
5. 在“Command”字段中輸入：

npx -y bitrefill-mcp-server

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

📚 詳細文檔

項目結構

bitrefill-mcp-server/
├── src/
│   ├── main.ts                 # 主程序入口
│   ├── tools/                  # 各個工具實現
│   │   ├── search.ts           # 搜索功能
│   │   ├── detail.ts           # 詳細信息查詢
│   │   └── categories.ts       # 類別管理
├── .env.example               # 環境變量示例文件
└── package.json                # 項目依賴及腳本配置

環境變量

在根目錄創建 .env 文件，並添加以下內容：

BITREFILL_API_SECRET=your_api_key_here
BITREFILL_API_ID=your_api_id_here

💻 使用示例

基礎用法

搜索禮品卡

{
  "tool": "search",
  "args": ["bitcoin", "ethereum"]
}

查詢詳細信息

{
  "tool": "detail",
  "args": ["BTC"]
}

管理類別

{
  "tool": "categories",
  "command": "list"
}

⚠️ 注意事項

⚠️ 重要提示

• 服務器默認綁定到 localhost:4012。
• 確保環境變量正確設置，以啟用 create_invoice 工具。
• 使用 Docker 時，確保已安裝 Docker 並配置正確。

通過以上步驟，您可以輕鬆集成 Bitrefill 的 MCP 服務器，為您的應用添加強大的區塊鏈數據查詢功能。