Mint Chain MCP

MintChain MCP代币服务

MintChain MCP是一个模型上下文协议（MCP）服务器，它为人工智能代理和开发者提供了一键部署兼容ERC20的代币、检查代币元数据以及跟踪部署情况的功能。该项目同时提供了stdio和HTTP入口点，因此您可以将其集成到桌面MCP客户端中，或者将其作为共享服务进行托管。

特点/特性

• 🚀 表情符号“🚀”通常被用来表示火箭、快速上升或加速等含义，在中文中可以翻译为“🚀（火箭/快速上升）”或者根据具体语境用更贴切的词汇来表达。不过，由于表情符号本身具有直观性，直接使用“🚀”在很多情况下也能被广泛理解。 一键部署ERC20代币 – 使用单一的MCP工具调用，部署可定制的代币（名称、符号、小数位数、初始供应量、接收者）。
• 🧪 试管/实验器材（表情符号代表的常见含义） 干运行气体估算 – 在广播交易前，估算部署所需的气体（Gas）使用量。
• 🔍 翻译为中文是：“🔍”（这个符号本身在中文里通常不直接翻译，而是保留原样，表示放大镜，常用于表示搜索或查看细节）。不过，如果要结合上下文解释其用途，可以说：“🔍（放大镜符号）用于表示搜索、查看细节或调查。” 但具体翻译需根据上下文来确定。在这里，直接保留原样最为常见。 链上检查 – 获取任何已部署合约的代币元数据（名称、符号、小数位数、总供应量、所有者）。
• 📚 书籍 部署注册表 – 为通过服务部署的代币维护一个本地目录，以便快速参考。
• 🌐（表示“世界”或“互联网”的符号） 双运输（或“双重运输”） – 使用stdio进行本地MCP客户端操作，或启动HTTP服务器以进行远程集成。

入门指南/开始使用

1. 安装依赖项

npm install

2. 配置环境

创建一个 .env 文件（或导出变量）中包含您计划目标的EVM网络的凭据：

MINTCHAIN_RPC_URL=https://your-evm-endpoint.example
MINTCHAIN_PRIVATE_KEY=0xabcdef...          # Account with deploy permissions
MINTCHAIN_CHAIN_ID=1                       # Optional, inferred if omitted
MINTCHAIN_DEFAULT_DECIMALS=18              # Optional, defaults to 18
MINTCHAIN_EXPLORER=https://etherscan.io    # Optional, used to build explorer links
MINTCHAIN_DATA_DIR=./.mintchain            # Optional, registry storage location

⚠️ 永远不要提交私钥。请使用专门的部署账户，这些账户应具有有限的资金和权限。

3. 构建项目

npm run build

4. 运行MCP服务器

标准I/O模式（非常适合本地MCP客户端）

npm run start:stdio

将您的MCP兼容客户端配置为通过（指定方式）启动编译后的二进制文件 npx -y mintchain-mcp 或者 node build/index.js。

HTTP 模式（适用于远程代理）

npm run start:http

服务器监听在 PORT （默认为 8080) 并揭示：

• GET /health – 基本的现场表演要素及工具清单。
• GET /mcp/tools – 发现可用工具。
• POST /mcp/tools/:name – 使用（某种方式/工具）执行一个工具 {"arguments": { ... }} 有效载荷。

可用工具

示例 deploy_token 有效载荷

{
  "name": "MintChain Credit",
  "symbol": "MINT",
  "initialSupply": "1000000",
  "decimals": 18,
  "recipient": "0xYourRecipientAddress",
  "dryRun": false
}

开发技巧

• 使用 npm run dev:stdio 或者 npm run dev:http 对于热加载工作流（需要 tsx）。
• 已部署的代币元数据存储在 MINTCHAIN_DATA_DIR （默认： ./.mintchain/deployedTokens.json）。
• 这个打包的Solidity合约是一个轻量级的ERC20实现，具有由所有者控制的铸造/销毁功能以及可配置的小数位数。
• 仅用于模拟运行估算，设置 dryRun: true 以避免在广播交易时仍能看到预期的燃气使用量。

许可证

Apache 2.0 © MintChain Labs（译文：Apache 2.0 许可 © MintChain Labs）。