人链 MCP 服务器

一个用于与人链（Cosmos SDK）区块链交互的模型上下文协议（MCP）服务器。该服务器提供发送代币、委托给验证节点、查询余额等功能，支持使用 MCP 协议。

功能

• 发送代币到其他地址（银行转账）
• 委托代币给验证节点（质押）
• 查询账户余额
• 获取验证节点信息
• 签署并广播任意交易
• 通过环境变量配置助记词和网络
• 可选 Dukong 测试网和主网
• 支持标准输入输出和 HTTP+SSE 两种传输模式

已提供的工具

银行操作

• 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：交易签名工具

环境变量

• MNEMONIC：必需。用于钱包的种子短语。
• CUSTOM_NETWORKS：可选。包含额外网络配置的 JSON 字符串。

人链 MCP 服务器文档

概述

mantrachain-mcp-server 是一个基于 Node.js 的工具，支持通过 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"
  }
}'

功能

基本功能

1. 助记词管理：

   • 生产助记词
   • 备份和恢复助记词

2. 钱包操作：

   • 查询余额
   • 发送代币

3. 质押管理：

   • 委托给验证节点
   • 取消委托

4. 智能合约交互：

   • 调用只读函数
   • 部署新合约
   • 与现有合约交互

5. IBC 支持：

   • 发起 IBC 转账
   • 查询通道状态

扩展功能

1. 网络插件：

   • 支持多种区块链协议
   • 可扩展的网络配置

2. 自定义命令：

   • 创建和注册自定义工具
   • 实现特定网络的操作

使用示例

基本用法

# 发送代币
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'
        }
      }
    }
  ]
}

配置文件

核心配置（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，我们期待您的反馈与合作。