🚀 人链 MCP 服务器
这是一个用于与人链（Cosmos SDK）区块链交互的模型上下文协议（MCP）服务器。它提供了丰富的功能，如发送代币、委托给验证节点、查询余额等，并且支持使用 MCP 协议。
🚀 快速开始
安装
全球安装（推荐）
使用 npm 进行全局安装：
npm install -g mantrachain-mcp-server
本地构建
如果需要从源代码构建，请运行以下命令：
git clone [仓库地址]
cd mantrachain-mcp-server
npm install
运行服务器
安装完成后，可以通过以下命令启动 MCP 服务器：
mantrachain-mcp-server start
默认情况下，服务器将在 localhost:3001 上运行。
配置环境变量
在启动服务器之前，请确保已设置必要的环境变量：
# 示例配置
export MNEMONIC="your_mnemonic_phrase"
export CUSTOM_NETWORKS='{
"testnet": {
"chainId": "test-chain-1",
"rpcUrl": "http://localhost:26657"
}
}'
✨ 主要特性
- 发送代币到其他地址（银行转账）
- 委托代币给验证节点（质押）
- 查询账户余额
- 获取验证节点信息
- 签署并广播任意交易
- 通过环境变量配置助记词和网络
- 可选 Dukong 测试网和主网
- 支持标准输入输出和 HTTP+SSE 两种传输模式
📦 安装指南
全球安装（推荐）
npm install -g mantrachain-mcp-server
本地构建
git clone [仓库地址]
cd mantrachain-mcp-server
npm install
💻 使用示例
基础用法
# 发送代币
mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000
# 查询余额
mantrachain-mcp-server query balance --address my_address
# 委托给验证节点
mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000
高级用法
# 定义自定义命令（配置文件 `config/plugins.js`）
module.exports = {
plugins: [
{
name: 'custom-plugin',
description: 'Custom transaction handler',
handlers: {
'tx-custom': {
method: 'handleCustomTx'
}
}
}
]
}
📚 详细文档
已提供的工具
银行操作
- bank-send：向其他地址发送代币
- get-balance：获取地址的余额（默认使用自己的地址，若未指定）
质押操作
- delegate：委托/质押代币给验证节点
- undelegate：取消委托/解质押代币
- claim-rewards：为特定验证节点领取奖励
- get-validators：获取所有验证节点
- get-delegations：获取地址的当前质押信息
- get-available-rewards：获取地址的所有可用奖励
网络操作
- get-account-info：获取当前账户信息
- get-block-info：获取区块信息
- query-network：对链 API 执行通用网络查询
IBC 操作
- ibc-transfer：通过IBC 转账发送代币
智能合约操作
- contract-query：通过执行只读函数查询智能合约
- contract-interact：与智能合约交互
- contract-deploy：部署智能合约
其他工具
- keygen：生成助记词和密钥对
- mnemonic-backup：备份助记词
- tx-signer：交易签名工具
配置文件
核心配置（config/core.js）
module.exports = {
mnemonic: process.env.MNEMONIC,
networks: {
mainnet: {
chainId: 'main-chain-1',
rpcUrl: 'https://main.rpc.provider'
},
testnet: {
chainId: 'test-chain-1',
rpcUrl: 'http://localhost:26657'
}
}
}
插件配置（config/plugins.js）
module.exports = {
plugins: [
{
name: 'eth-wallet',
description: 'Ethereum wallet integration',
handlers: {
'query-balance': {
method: 'getBalance'
}
}
}
]
}
教程
第一课：安装与配置
- 安装 MCP 服务器：
npm install -g mantrachain-mcp-server
- 设置环境变量：
export MNEMONIC="your_mnemonic_phrase"
- 启动服务器：
mantrachain-mcp-server start
第二课：使用钱包
- 生成地址：
mantrachain-mcp-server wallet generate-address --mnemonic your_mnemonic
- 发送代币：
mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000
第三课：质押与委托
- 查询验证节点：
mantrachain-mcp-server query validators
- 委托给指定节点：
mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000
参考文档
- 核心配置
- 插件系统
- 命令行接口
教程
- 快速入门
- 高级主题
- 自定义网络
🔧 技术细节
mantrachain-mcp-server 是一个基于 Node.js 的工具，支持通过 MCP 协议与区块链网络交互。它提供了一个灵活且强大的框架，适用于多种区块链协议和应用。
📄 许可证
文档中未提及许可证信息。
贡献指南
欢迎社区贡献！请参考贡献指南了解如何参与开发。
感谢您使用 mantrachain-mcp-server，我们期待您的反馈与合作。