Mantrachain MCP

🚀 人鏈 MCP 服務器

人鏈 MCP 服務器是一個用於與人鏈（Cosmos SDK）區塊鏈交互的模型上下文協議（MCP）服務器。該服務器提供發送代幣、委託給驗證節點、查詢餘額等功能，支持使用 MCP 協議。

✨ 主要特性

• 豐富的交互功能：支持發送代幣到其他地址、委託代幣給驗證節點、查詢賬戶餘額、獲取驗證節點信息、簽署並廣播任意交易等操作。
• 靈活的網絡配置：可通過環境變量配置助記詞和網絡，可選 Dukong 測試網和主網。
• 多樣的傳輸模式：支持標準輸入輸出和 HTTP+SSE 兩種傳輸模式。

📦 安裝指南

全球安裝（推薦）

使用 npm 進行全局安裝：

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

環境變量

• MNEMONIC：必需。用於錢包的種子短語。
• CUSTOM_NETWORKS：可選。包含額外網絡配置的 JSON 字符串。

配置文件

核心配置（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，我們期待您的反饋與合作。