🚀 beeper-mcp
beeper-mcp是一个运行在Binance智能链（BSC）上的后端服务，专门用于执行beeper事务。它提供了一系列与BSC区块链交互的工具，涵盖余额查询、BNB和代币转账、Pancakeswap上的代币交换以及beeper奖励兑换等功能。
✨ 主要特性
- 余额查询：支持获取BNB和代币的余额。
- 转账功能：可进行BNB和代币的转账操作。
- 代币交换：能在Pancakeswap上实现代币的交换。
- 价格获取：可以获取代币的价格。
- 交易买卖：支持使用BNB买卖代币。
- 奖励兑换：能够兑换beeper代币奖励。
- 地址管理：可管理默认钱包地址和代币地址。
📦 安装指南
先决条件
- Python版本需大于等于3.10。
- 能够访问BSC网络（主网或测试网）。
- 拥有钱包地址及对应的私钥。
环境变量配置
在项目根目录下创建一个.env文件，并包含以下变量：
BEEPER_CHAIN=
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
# 通过标准输入输出启动服务器
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 "
}
}
}
}
⚠️ 重要提示
- 所有金额参数均使用Decimal类型，以最小单位表示（例如，0.01 BNB）。
- 默认情况下，所有交易均需手动确认。