关键词

区块链Cosmos SDKMantraChainDeFiWeb3

项目简介

MantraChain MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型（LLM）客户端提供与 MantraChain 区块链交互的桥梁。它通过标准化的 MCP 协议，使得 LLM 应用能够安全、便捷地访问 MantraChain 的数据和功能，例如发送代币、参与质押、查询账户信息、执行智能合约以及进行去中心化交易所（DEX）操作等。

主要功能点

  • 资源管理: 提供 'networks://all' 和 'openapi://{networkName}' 资源，分别用于获取网络配置信息和 OpenAPI 规范，方便客户端了解服务器能力和可用的区块链网络。
  • 全面的区块链操作工具:
    • 银行操作: 支持发送代币（bank-send）、查询余额（get-balance）。
    • 质押操作: 支持代币质押（delegate）、解质押（undelegate）、领取奖励（claim-rewards）、查询验证器信息（get-validators）、查询质押信息（get-delegations）、查询可用奖励（get-available-rewards）。
    • 网络操作: 支持获取账户信息（get-account-info）、获取区块信息（get-block-info）、执行自定义网络查询（query-network）。
    • IBC 操作: 支持跨链代币转移（ibc-transfer）。
    • 智能合约操作: 支持查询合约状态（contract-query）、执行合约方法（contract-execute）。
    • DEX 操作: 支持查询 DEX 交易对（dex-get-pools）、查找交易路径（dex-find-routes）、模拟交易（dex-simulate-swap）、执行交易（dex-swap）。
    • 交易操作: 支持签名和广播通用交易（sign-and-broadcast）。
  • 多传输协议支持: 同时支持 Stdio 和 HTTP+SSE 两种传输模式，满足不同应用场景的需求。

安装步骤

  1. 安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node 包管理器)。
  2. 安装 MantraChain MCP 服务器:
    • 全局安装 (推荐): 
      npm install -g mantrachain-mcp
    • 或者，您也可以选择在项目本地安装: 
      npm install mantrachain-mcp

服务器配置

MantraChain MCP 服务器需要配置在 MCP 客户端中，以便客户端能够连接并使用服务器提供的功能。以下是配置信息示例，您需要根据您的 MCP 客户端进行配置。

1. Stdio 模式配置 (默认)

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mantrachain-mcp@latest"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC"
      }
    }
  }
}
  • 'server name': 'mantrachain-mcp' (服务器名称，客户端用于标识和调用)
  • 'command': 'npx' (启动命令，使用 npx 运行 npm 包)
  • 'args':
    • '-y': (npx 参数，自动安装包)
    • 'mantrachain-mcp@latest': (要运行的 npm 包名和版本)
  • 'env':
    • 'MNEMONIC': (必填) 您的 MantraChain 钱包助记词，用于签名交易。请替换为您的助记词。

2. HTTP+SSE 模式配置

{
  "mcpServers": {
    "mantrachain-mcp-sse": {
      "url": "http://localhost:3000/sse",
      "transportType": "sse"
    }
  }
}
  • 'server name': 'mantrachain-mcp-sse' (服务器名称)
  • 'url': 'http://localhost:3000/sse' (SSE 连接的 URL，服务器默认监听 3000 端口)
  • 'transportType': 'sse' (指定传输类型为 Server-Sent Events)

HTTP+SSE 模式服务器启动命令 (在服务器端执行)

export MNEMONIC="YOUR_MNEMONIC" # 设置助记词环境变量
mantrachain-mcp -r # 启动 HTTP+SSE 模式服务器

或者使用 npx 启动：

export MNEMONIC="YOUR_MNEMONIC"
npx -y mantrachain-mcp@latest -- -r
  • '-r': 标志位，用于启动 HTTP+SSE 传输模式。

环境变量

  • 'MNEMONIC': (必填) MantraChain 钱包的助记词。
  • 'CUSTOM_NETWORKS': (可选) JSON 格式的自定义网络配置，用于添加非默认网络。

基本使用方法

  1. 启动 MCP 服务器: 根据您选择的传输模式（Stdio 或 HTTP+SSE）启动 MantraChain MCP 服务器。
  2. 配置 MCP 客户端: 在您的 MCP 客户端应用中，添加上面提供的服务器配置信息。
  3. 连接服务器并调用工具: 使用 MCP 客户端连接到 MantraChain MCP 服务器。成功连接后，您可以使用客户端提供的界面或命令来调用服务器提供的各种工具和资源，例如查询余额、发送交易等。

注意: 请务必妥善保管您的助记词，避免泄露，并了解区块链操作的风险。

信息

分类

网页与API

访问项目