MantraChain MCP 服务器

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

特征

• 将代币发送到其他地址（银行发送）

• 将代币委托给验证者（质押）

• 查询账户余额

• 获取验证者信息

• 签署并广播任意交易

• 通过环境变量配置助记词和网络

• 在 Dukong 测试网和主网之间进行选择

• 支持 stdio 和 HTTP+SSE 传输模式

Related MCP server: MCP Blockchain Query Server

可用工具

银行业务

• 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-execute ：执行智能合约上改变状态的函数

DEX 操作

• dex-get-pools ：从 DEX 获取所有可用的流动性池

• dex-find-routes ：查找两个令牌之间可用的交换路线

• dex-simulate-swap ：模拟代币交换以获得预期结果，但不执行它

• dex-swap ：在 DEX 上执行代币交换，并进行滑点保护

事务操作

• sign-and-broadcast ：签署并广播通用交易

可用资源

• networks://all ：JSON 资源，显示所有可用网络及其配置

• openapi://{networkName} ：指定网络的 OpenAPI/Swagger 规范

运行服务器

服务器可以以两种模式运行：

1. **Stdio 模式（默认）：**通过标准输入/输出进行通信。这是直接运行服务器或通过npx运行服务器时的默认模式。

   # Using installed package
   mantrachain-mcp
   
   # Using npx
   npx -y mantrachain-mcp@latest
   

2. **HTTP+SSE 模式：**在 3000 端口运行 HTTP 服务器，通过服务器发送事件 (SSE) 进行通信。使用-r参数或专用 npm 脚本激活此模式。

   # Using installed package
   mantrachain-mcp -r
   
   # Using npx
   export MNEMONIC="YOUR_MNEMONIC"
   export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON"
   npx -y mantrachain-mcp@latest -- -r
   

   在 HTTP 模式下运行时，服务器监听：

   • GET /sse ：建立 SSE 连接。

   • POST /messages?sessionId=<id> ：接收客户端请求。

MCP 配置

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 MantraChain MCP 服务器：

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 字符串。