Mint Club V2

Mint Club V2 MCP 服务

一个 MCP 服务，提供 Mint Club V2 Bond 操作，以及跨十条主网和两条测试网的有限本地 Uniswap ZapV2 路由功能。

npm 包 · 代码仓库 · CLI 参考 · ElizaOS 插件

该服务委托给 @mint.club/v2-cli，因此 CLI 仍是合约、代币解析、路由发现、定价和交易的唯一事实来源。链键从 CLI 发布的 chain-registry.json 加载，而不在 MCP 包中重复维护。

配置

需要 Node.js 18 或更高版本。大多数 MCP 客户端都可以通过 npx 直接启动此包：

{
  "mcpServers": {
    "mintclub": {
      "command": "npx",
      "args": ["-y", "@mint.club/v2-mcp@2"]
    }
  }
}

若要全局安装，请运行 npm install -g @mint.club/v2-mcp，并改用 "command": "mintclub-mcp"。MCP 包会自动安装兼容的 @mint.club/v2-cli 2.x 运行时依赖。

只读工具无需钱包。写入工具和 wallet_balance 需要服务器进程中的 PRIVATE_KEY，或 ~/.mintclub/.env 中的密钥。请通过 MCP 客户端的密钥／环境变量配置功能提供密钥。若要生成专用本地钱包，请安装 CLI，并在可信终端中运行 mc wallet --generate。

切勿将密钥存入已提交的 MCP 配置，或粘贴到模型对话中。请使用资金有限的专用钱包。

每个写入工具都必须明确指定 chain，并将字面值结构化参数 "confirm": true 设为 true。此字段可防止意外遗漏，但不能证明用户已授权：请将 MCP 主机配置为对标记为破坏性的工具要求交互式批准。客户端必须在设置该参数前显示完整的链、资产、金额和限制；服务器绝不会自行推断用户已确认。

工具

该服务提供九个特定于协议的工具：

工具	说明
token_info	代币供应量、储备、曲线、价格和美元价值
token_price	以储备代币和美元计价的价格
wallet_balance	指定钱包在链上的余额
buy_token	使用储备 ERC-20 调用 MCV2_Bond.mint
sell_token	调用 MCV2_Bond.burn 以获取储备 ERC-20
zap_buy	精确路由输入资产 → MCV2_ZapV2.zapMint
zap_sell	MCV2_ZapV2.zapBurn → 路由输出资产
send_token	发送原生货币或 ERC-20 代币
create_token	创建 ERC-20 联合曲线代币

除名称、符号、储备和最大供应量外，create_token 还需要 curve、initialPrice 和 finalPrice。该工具采用 CLI 默认值，铸造和销毁版税均为 100 个基点（1%）；如需设置不同的版税，请直接使用 CLI。

此工具通过 CLI 在链上创建代币。之后请使用创建者钱包在 Mint Club 上配置徽标和网站链接；请参阅 CLI 元数据指南。无需调用匿名元数据 API。

读取工具可接受可选的规范 chain 属性，默认为 Base。每个写入工具都必须明确指定 chain。支持的值如下：

ethereum · optimism · arbitrum · avalanche · base · polygon · bsc · zora · unichain · robinhood · sepolia · base-sepolia

此集成不支持 Blast。

send_token 还必须明确指定 token 资产。选定链的原生货币请使用字面值 "NATIVE"；否则请提供 ERC-20 符号或地址。

ZapV2 输入

zap_buy 需要：

{
  "chain": "arbitrum",
  "token": "0xMINT_CLUB_TOKEN",
  "inputToken": "USDT",
  "inputAmount": "10",
  "slippage": "1",
  "confirm": true
}

可选参数 minTokens 以 Mint Club 代币计价。inputAmount 为精确数量。

zap_sell 需要：

{
  "chain": "unichain",
  "token": "0xMINT_CLUB_TOKEN",
  "amount": "100",
  "outputToken": "USDC",
  "slippage": "1",
  "confirm": true
}

可选参数 minOutput 以输出资产计价。amount 为要销毁的 Mint Club 代币精确数量。

传入 zap_buy 或 zap_sell 的 Mint Club 代币可以是 ERC-20 或 ERC-1155；ERC-1155 的数量必须为整数。路由的输入和输出资产必须是原生货币或 ERC-20 代币。

CLI 会枚举已配置的直接路由和经过一个中间代币的同类 V2/V3/V4 路由候选项，从中选出精确输入所得输出最高的路由，并使用 Universal Router SDK 对其进行编码。它不会调用外部路由 API，也不声称能找到全局最优路由。

ZapV2 已部署在上述所有支持的链上。部署地址由 @mint.club/v2-cli 维护；请参阅 CLI 合约表。

请求示例

• “获取 Base 上 SIGNET 的代币信息。” → token_info
• 在 Robinhood 上以 "confirm": true 确认调用 buy_token，购买 100 TOKEN。
• 在 Arbitrum 上以 "confirm": true 确认调用 zap_buy，使用恰好 10 USDT。
• 在 Unichain 上以 "confirm": true 确认调用 zap_sell，将 50 TOKEN 兑换为 USDC。
• 在 Robinhood 上以 "confirm": true 确认调用 create_token，创建由 USDG 支持的 My Token（MYT），最大供应量为 1,000,000，使用从 0.01 到 1 USDG 的线性曲线。

安全执行 CLI

工具参数通过 execFileSync argv 数组传递给 mc。用户值不会插入 shell 命令。对于写入工具，只有在验证 confirm === true 后，服务才会附加 CLI --yes。

设置 MINTCLUB_CLI 以覆盖 CLI 可执行文件路径。

开发

在仓库根目录运行：

npm ci
npm --prefix mcp run check
npm --prefix mcp test
npm --prefix mcp run build

许可证

MIT。发布的 tarball 包含项目 LICENSE，以及生成的 THIRD_PARTY_NOTICES.md，其中涵盖 MCP 服务中打包的所有软件包。