Beeper MCP 9iv

🚀 beeper-mcp

beeper-mcp是一個運行在Binance智能鏈（BSC）上的後端服務，主要用於執行beeper事務。它提供了一系列與BSC區塊鏈交互的工具，涵蓋餘額查詢、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運行

sae服務默認在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和代幣
• 在Pancakeswap上交換代幣
• 獲取代幣價格
• 買賣代幣
• 兌換beeper代幣獎勵
• 管理默認錢包地址和代幣地址

📚 詳細文檔

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）。
• 默認情況下，所有交易均需手動確認。