Mantrachain MCP

🚀 人链 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'
        }
      }
    }
  ]
}

教程

第一课：安装与配置

1. 安装 MCP 服务器：

npm install -g mantrachain-mcp-server

2. 设置环境变量：

export MNEMONIC="your_mnemonic_phrase"

3. 启动服务器：

mantrachain-mcp-server start

第二课：使用钱包

1. 生成地址：

mantrachain-mcp-server wallet generate-address --mnemonic your_mnemonic

2. 发送代币：

mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000

第三课：质押与委托

1. 查询验证节点：

mantrachain-mcp-server query validators

2. 委托给指定节点：

mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000

参考文档

• 核心配置
• 插件系统
• 命令行接口

教程

• 快速入门
• 高级主题
• 自定义网络

🔧 技术细节

mantrachain-mcp-server 是一个基于 Node.js 的工具，支持通过 MCP 协议与区块链网络交互。它提供了一个灵活且强大的框架，适用于多种区块链协议和应用。

📄 许可证

文档中未提及许可证信息。

贡献指南

欢迎社区贡献！请参考贡献指南了解如何参与开发。

感谢您使用 mantrachain-mcp-server，我们期待您的反馈与合作。