beeper-mcp

一个用于在币安智能链 (BSC) 上执行 beeper 交易的后端服务。此服务提供了一组与 BSC 区块链交互的工具，包括余额检查、余额转移、代币转移、Pancakeswap 中的代币交换和 beeper 奖励领取。

功能

• 获取 BNB 和代币余额
• 转移 BNB 和代币
• 在 Pancakeswap 中交换代币
• 获取代币价格
• 购买和出售代币
• 领取 beeper 代币的奖励
• 管理默认钱包和代币地址

前提条件

• Python >=3.10
• 访问 BSC 网络（主网或测试网）
• 钱包账户和私钥

环境变量

在项目根目录中创建一个 .env 文件，包含以下变量：

BEEPER_CHAIN=<bsc 或 bsc-testnet>
BEEPER_ACCOUNT=<你的钱包地址>
BEEPER_SECRET_KEY=<你的私钥>
BEEPER_TARGET_TOKEN=<默认代币地址>  # 可选

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
# 通过 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": "你的账户, 0x...",
        "BEEPER_SECRET_KEY": "你的私钥或在 .env 中",
        "BEEPER_TARGET_TOKEN": "默认代币地址",
        "BEEPER_CHAIN": "链类型 <bsc/bsc-testnet>"
      }
    }
  }
}

注意事项

• 所有金额均以原生单位表示（例如，BNB、代币）
• 代币地址应以正确的格式提供
• 确保您有足够的 BNB 用于 gas 费用
• 该服务支持 BSC 主网和测试网
• 所有操作都会返回包含交易哈希和状态信息的详细响应对象
• 该服务包括内置的错误处理和交易状态跟踪

用法

在 llm 聊天中调用函数

• 显示钱包并购买代币

• 出售代币