🚀 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）。
• 默认情况下，所有交易均需手动确认。