Bitrefill Bitrefill MCP Server

🚀 Bitrefill MCP サーバー

これは TypeScript ベースの MCP サーバーで、Bitrefill サービスへのアクセス権を提供します。これにより、ギフトカードの検索や携帯電話の充電などが可能です。このサーバーは、Bitrefill の機能を AI アシスタントに公開するために、モデルコンテキストプロトコル (Model Context Protocol) を実装しています。

🚀 クイックスタート

動作原理

このサーバーは、Model Context Protocol (MCP) を使用して AI アシスタントと通信します。以下がその動作フローです。

1. 依存関係のインストール：

   npm install
   

2. サーバーのビルド：

   npm run build
   

3. 開発モード（自動再構築）：

   npm run watch
   

4. デバッグ： MCP モニターを使用してデバッグします。コマンドは以下の通りです。

   npm run inspector
   

   このツールは、デバッグツールにアクセスするためのブラウザ URL を提供します。

📦 インストール

Smithery を通じたインストール

Claude Desktop に 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": ["-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 を使用した実行

1. イメージをビルドします。

   docker build -t bitrefill-mcp-server .
   

2. コンテナを起動します。

   docker run -e BITREFILL_API_SECRET=your_api_key_here -e BITREFILL_API_ID=your_api_id_here bitrefill-mcp-server
   

3. 開発時にコードをマウントします。

   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 サーバーを簡単に統合し、アプリに強力なブロックチェーンデータ照会機能を追加できます。