Beeper MCP 9iv

🚀 beeper-mcp

このサービスは、Binance Smart Chain（BSC）上でbeeperトランザクションを実行するバックエンドサービスです。BSCブロックチェーンとの相互作用に必要な一連のツールを提供し、残高照会、BNBおよびトークンの送金、Pancakeswapでのトークン交換、beeper報酬の請求などの機能を備えています。

✨ 主な機能

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

📦 インストール

前提条件

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

環境変数

プロジェクトのルートディレクトリに.envファイルを作成し、以下の変数を含めてください。

BEEPER_CHAIN=<bsc または bsc-testnet>
BEEPER_ACCOUNT=<your-wallet-address>
BEEPER_SECRET_KEY=<your-private-key>
BEEPER_TARGET_TOKEN=<デフォルトのトークンアドレス>  # オプション

💻 使用例

サービスの実行

git clone https://github.com/unibaseio/beeper-mcp.git
cd beeper-mcp
# 標準入出力でサーバーを起動する
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>"
      }
    }
  }
}

📚 ドキュメント

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: 指定されたトークンの報酬を請求する

注意事項

⚠️ 重要提示

すべての金額パラメータはDecimal型で、最小単位で表されます（例：0.01 BNB）。

💡 使用建议

デフォルトでは、すべての取引は手動で確認する必要があります。