Mantrachain Mcp

MantraChain MCP 服务

一个用于与 MantraChain（Cosmos SDK）区块链交互的模型上下文协议（MCP）服务。此服务使用 MCP 协议提供发送代币、委托给验证者、查询余额等工具。

功能

• 向其他地址发送代币（银行转账）
• 将代币委托给验证者（质押）
• 查询账户余额
• 获取验证者信息
• 对任意交易进行签名并广播
• 通过环境变量配置助记词和网络
• 可选择 Dukong 测试网或主网
• 同时支持 stdio 和 HTTP+SSE 传输模式

可用工具

银行业务

• bank-send：向其他地址发送代币（支持在单笔交易中发送多种币）
• get-balance：获取某个地址的余额（如果未提供地址，则默认为你自己的地址）
• get_evm_balance：获取 EVM 地址的原生代币（OM）余额
• get_token_balance：获取某个地址的 ERC20 代币余额
• get_nft_balance：获取某个地址在某个集合中的 ERC721 NFT 数量
• get_erc1155_balance：获取指定代币 ID 的 ERC1155 代币余额
• get_address_from_mnemonic：获取由助记词推导出的 EVM 地址

质押业务

• delegate：向验证者委托／质押代币
• undelegate：从验证者取消委托／解除质押代币
• claim-rewards：领取特定验证者的奖励
• get-validators：获取所有验证者
• get-delegations：获取某个地址当前的质押信息
• get-available-rewards：获取某个地址的所有可用奖励

网络业务

• get-account-info：获取当前账户信息
• get-block-info：从 Cosmos（cometbft）RPC 获取区块信息
• get-block-info-evm：从 EVM RPC 获取区块信息
• query-network：通过链 API 执行通用网络查询

IBC 业务

• ibc-transfer：通过 IBC 转账发送代币

智能合约业务

• cosmwasm-contract-query：查询 CosmWasm 智能合约（只读）
• cosmwasm-contract-execute：在 CosmWasm 合约上执行函数（会更改状态）
• read_evm_contract：从 EVM 合约读取数据（view/pure 函数）
• write_evm_contract：向 EVM 合约写入数据（会更改状态的函数）
• deploy_evm_contract：部署新的 EVM 合约
• is_contract：检查某个地址是合约还是 EOA

DEX 业务

• dex-get-pools：获取 DEX 上所有可用的流动性池
• dex-find-routes：查找两种代币之间可用的兑换路径
• dex-simulate-swap：模拟代币兑换，以获取预期结果而不实际执行兑换
• dex-swap：在 DEX 上执行代币兑换，并提供滑点保护

交易业务

• sign-and-broadcast：对通用 Cosmos 交易进行签名并广播
• get_transaction：按哈希获取特定 EVM 交易的详细信息
• get_transaction_receipt：按哈希获取 EVM 交易收据
• estimate_gas：估算交易的 Gas 费用
• transfer_om：通过 EVM 转账原生代币（OM）
• transfer_erc20：向其他地址转账 ERC20 代币
• approve_token_spending：授权其他地址使用你的 ERC20 代币
• transfer_nft：向其他地址转账 ERC721 NFT
• transfer_erc1155：向其他地址转账 ERC1155 代币
• transfer_token：向某个地址转账 ERC20 代币

可用资源

• networks://all：显示所有可用网络及其配置的 JSON 资源
• openapi://{networkName}：指定网络的 OpenAPI/Swagger 规范

运行服务

服务可以通过两种模式运行：

1. Stdio 模式（默认）： 通过标准输入/输出进行通信。直接运行服务或通过 npx 运行时，默认使用此模式。

   # 使用已安装的软件包
   mantrachain-mcp
   
   # 使用 npx
   npx -y mantrachain-mcp@latest
   
   

2. Streamable HTTP 模式： 在端口 3000 上运行 HTTP 服务，通过服务器发送事件（SSE）进行通信。使用 --http 标志或专用 npm 脚本启用此模式。

   # 使用已安装的软件包
   mantrachain-mcp --http
   
   # 使用 npx
   export MNEMONIC="YOUR_MNEMONIC"
   export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON"
   npx -y mantrachain-mcp@latest -- --http
   

MCP 配置

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 MantraChain MCP Server：

npx -y @smithery/cli install @allthatjazzleo/mantrachain-mcp --client claude

要与 MCP 客户端应用程序集成，请将服务配置添加到 MCP 客户端配置文件中：

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mantrachain-mcp@latest"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC",
        "CUSTOM_NETWORKS": "{\"my-custom-net\":{\"rpcEndpoint\":\"https://rpc.custom-network.io\",\"apiEndpoint\":\"https://api.custom-network.io\",\"chainId\":\"my-custom-net-1\",\"prefix\":\"custom\",\"denom\":\"ucustom\",\"gasPrice\":\"0.01\",\"isMainnet\":false}}"
      }
    }
  }
}

在 cline 中连接远程 MCP 服务：

{
  "mcpServers": {
    "mantrachain-mcp-sse": {
      "url": "http://localhost:3000/sse",
      "transportType": "sse"
    }
  }
}

如果在本地构建软件包，而不是全局构建

构建软件包后，可以直接从构建目录运行。请确保将 your_path 替换为构建目录的实际路径。

npm run build

然后，可以使用以下配置：

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "node",
      "args": [
        "your_path/mantrachain-mcp/build/index.js"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC"
      }
    }
  }
}

环境变量

• MNEMONIC：必填。要使用的钱包的助记词种子短语。
• CUSTOM_NETWORKS：可选。包含附加网络配置的 JSON 字符串。