Bitrefill MCP Server

🚀 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 で利用可能なギフトカードと電子通貨を検索できます。
• 携帯電話の充電：携帯電話の充電サービスを提供します。
• その他の関連サービス：その他の関連サービスも提供します。

📦 インストール

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

🔧 設定

ルートディレクトリに .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 を提供します。

🐳 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

📚 ドキュメント

各クライアントでの使用方法

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     # プロジェクトの依存関係と設定