beeper-mcp

beeper-mcp

Binance Smart Chain（BSC）で beeper のトランザクションを実行するバックエンドサービスです。このサービスは、残高確認、残高の送金、トークンの送金、Pancakeswap でのトークンスワップ、beeper 報酬の請求など、BSC ブロックチェーンとやり取りするためのツール一式を提供します。

機能

• BNB とトークンの残高を取得
• BNB とトークンを送金
• Pancakeswap でトークンをスワップ
• トークン価格を取得
• トークンを売買
• beeper トークンの報酬を請求
• デフォルトのウォレットアドレスとトークンアドレスを管理

前提条件

• Python >=3.10
• BSC ネットワーク（メインネットまたはテストネット）へのアクセス
• ウォレットアカウントと秘密鍵

環境変数

プロジェクトのルートに、次の変数を含む .env ファイルを作成します。

BEEPER_CHAIN=<bsc or bsc-testnet>
BEEPER_ACCOUNT=<your-wallet-address>
BEEPER_SECRET_KEY=<your-private-key>
BEEPER_TARGET_TOKEN=<default-token-address>  # Optional

API エンドポイント

このサービスは、次の MCP ツールを公開します。

ウォレットとトークンの管理

• get_default_wallet_address() -> str: デフォルトのウォレットアドレスを取得
• get_default_token_address() -> str: デフォルトのトークンアドレスを取得
• switch_default_token_address(new_token_address: str) -> str: デフォルトのトークンアドレスを新しいアドレスに切り替え

残高操作

• get_balance(address: str) -> str: アドレスの BNB 残高を取得
• get_token_balance(address: str, token_address: str) -> str: アドレスのトークン残高を取得

送金操作

• transfer(recipient_address: str, amount: Decimal = 0.01) -> dict: アドレスに BNB を送金
• transfer_token(recipient_address: str, token_address: str, amount: Decimal = 0.01) -> dict: アドレスにトークンを送金

取引操作

• swap_token(token_in: str, token_out: str, amount: Decimal = 0.01) -> dict: トークン同士をスワップ
• get_token_price(token_address: str) -> float: トークンの BNB 建て価格を取得
• buy_token(token_address: str, amount: Decimal = 0.01) -> dict: BNB でトークンを購入
• sell_token(token_address: str, amount: Decimal = 0.01) -> dict: トークンを BNB に交換

報酬操作

• claim_rewards(token_address: str) -> dict: トークンの報酬を請求

サービスの実行

git clone https://github.com/unibaseio/beeper-mcp.git
cd beeper-mcp
# start server over stdio
uv run src/beeper_mcp/server.py 

• sse を使用して起動

sse サービスはデフォルトでポート 8000 で起動します。--port 引数を使って別のポートを指定できます。

uv run src/beeper_mcp/server.py --port 8008 --transport=sse

Claude/Windsurf/Cursor/Cline での設定

{
  "mcpServers": {
    "beeper": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/beeper-mcp",
        "run", 
        "src/beeper_mcp/server.py"
        ],
      "env": {
        "BEEPER_ACCOUNT": "your account, 0x...",
        "BEEPER_SECRET_KEY": "your private key or in .env",
        "BEEPER_TARGET_TOKEN": "default token address",
        "BEEPER_CHAIN": "chain type <bsc/bsc-testnet>"
      }
    }
  }
}

注意事項

• すべての数量はネイティブ単位（例：BNB、トークン）です
• トークンアドレスは正しい形式で指定してください
• ガス代に十分な BNB があることを確認してください
• このサービスは BSC のメインネットとテストネットの両方に対応しています
• すべての操作は、トランザクションハッシュとステータス情報を含む詳細なレスポンスオブジェクトを返します
• このサービスには、トランザクションの組み込みエラー処理とステータス追跡機能が含まれています

使用方法

LLM チャットで関数を呼び出します

• ウォレットを表示してトークンを購入

• トークンを売却