内容
# 🐹 HamsterMCP
一个 [MCP](https://modelcontextprotocol.io) 服务器，允许 **Claude** （和任何MCP客户端）在 [HamsterBunker](https://hamsterbunker.com) 上启动防地毯代币—— Robinhood Chain上的启动平台——并读取实时代币数据。
只需告诉克劳德：
> 为我启动一个名为 Agent Coin 的代币，符号为 AGENT
它会部署一个不可变的1B供应代币，将整个供应锁定为流动性，并永久销毁LP。一次调用，即上链，防地毯。
## 工具
| 工具 | 功能 | 需要密钥 |
| --- | --- | --- |
| `launch_token` | 部署代币（不可变，全部供应锁定，LP销毁） | ✅ |
| `predict_token_address` | 预测确定性代币地址 | — |
| `get_token` | 代币的实时价格 / 市值 / 流动性 / 毕业信息 | — |
| `discover_tokens` | 通过 trending / new / top / graduating 发现代币 | — |
| `recent_launches` | 板块上的近期代币 | — |
| `token_trades` | 代币的近期链上买卖 | — |
| `trade_link` | 直接路由到正确场所的买卖链接 | — |
| `safety_check` | 代币交易前检查——LP是否销毁并锁定？ | — |
| `buy_hbnk` | 一键购买 $HBNK，HamsterBunker 自己的代币 | — |
所以你可以告诉克劳德类似的话，比如 *"HamsterBunker 上什么东西 trending"*， *"这个代币是否安全购买"*， *"给我买一些 HBNK"*，以及 *"给我启动一个代币"*（需要密钥）。
地址、字节码、RPC 和公共读取密钥从 HamsterBunker 配置中实时拉取，因此服务器与部署保持同步。
## 安装
```bash
git clone https://github.com/hamsterbunker/hamster-mcp
cd hamster-mcp
npm install
```
您需要 Node 18+。要启动（不仅仅是读取），您需要一个 Robinhood Chain 钱包，里面有大约 0.0015 ETH 作为燃料。
## 配置
### 克劳德桌面
在 `claude_desktop_config.json` 中添加（设置 → 开发者 → 编辑配置）：
```json
{
"mcpServers": {
"hamsterbunker": {
"command": "node",
"args": ["/absolute/path/to/hamster-mcp/src/server.mjs"],
"env": {
"WALLET_PRIVATE_KEY": "0xYOUR_LAUNCHER_KEY"
}
}
}
}
```
重启克劳德桌面。如果您只想使用读取工具，可以省略 `WALLET_PRIVATE_KEY`。
### 克劳德代码
```bash
claude mcp add hamsterbunker -e WALLET_PRIVATE_KEY=0xYOUR_LAUNCHER_KEY -- node /absolute/path/to/hamster-mcp/src/server.mjs
```
## 环境
| 变量 | 用途 |
| --- | --- |
| `WALLET_PRIVATE_KEY` | `launch_token` 的签名密钥。 Robinhood Chain 钱包中有燃料。**永远不要**硬编码或粘贴到聊天中——只在 MCP 客户端配置环境中设置。 |
| `HAMSTER_CONFIG_URL` | 可选。覆盖配置源（默认为实时站点）。 |
## 注意事项
- `launch_token` 是 **不可逆** 的：它部署一个不可变的代币并永久销毁 LP。在启动前请确认名称和符号。
- `creator` （费用钱包）赚取 1% 交易费的 90%。它不拥有或控制代币——没有所有者。
- 默认 DEX 是 Uniswap（Robinhood Chain 上最深的流动性）；传递 `dex: "sushi"` 以使用 SushiSwap。
- 私钥保留在服务器进程中。任何工具都不会返回私钥，私钥也不会发送到其他地方，只用于签署启动交易。
## License
MIT
