区块链查询服务器

MANTRA Chain MCP Server 是一个只读的区块链查询服务器,支持从Cosmos和EVM层查询MANTRA Chain数据,适用于非技术团队成员通过MCP兼容客户端直接查询区块链。

  • by Jasperpolak
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Jasperpolak/mantrachain-mcp

使用说明

MANTRA链MCP服务器

A. 只读 模型上下文协议 (MCP)查询服务器 曼特拉链条 --支持EVM的Cosmos SDK L1区块链。

专为非技术团队成员直接从以下位置查询区块链而构建 克劳德协作 无需CLI访问或钱包凭据。

特性

  • 跨Cosmos和EVM层的30个只读工具
  • 无需钱包或助记词——完全只读,无需签名
  • 支持主网(mantra-1)和测试网(mantra-dukong-1)
  • 用于云部署的流式HTTP传输(cloud Run等)
  • 本地MCP客户端的标准传输(Claude Desktop、Cursor等)
  • 通过环境变量自定义网络支持

可用工具

余额查询

工具 说明
get-balance 获取Cosmos地址的本机令牌余额
get_evm_balance 获取EVM地址的本机令牌余额
get_token_balance 获取ERC20代币余额
get_nft_balance 获取地址的ERC721 NFT计数
get_erc1155_balance 获取特定令牌ID的ERC1155令牌余额

质押

工具 说明
get-validators 列出所有验证器
get-delegations 召集代表团发表演讲
get-available-rewards 获得无人认领的质押奖励

网络和块

工具 说明
get-block-info 获取Cosmos区块信息(按高度或最新)
get-block-info-evm 获取EVM块信息
query-network 对链REST/RPC API执行通用查询

Cosmos交易

工具 说明
search_cosmos_txs 按事件(发件人、收件人、身高、消息类型)搜索交易
get_cosmos_tx 通过哈希值获取单笔交易
get_cosmos_txs_by_address 获取一个地址的所有交易(发送+接收)

EVM交易

工具 说明
get_transaction 通过哈希获取EVM交易详细信息
get_transaction_receipt 获取EVM交易收据
estimate_gas 估算交易的天然气

智能合约

工具 说明
cosmwasm-contract-query 查询CosmWasm智能合约
read_evm_contract 从EVM合约中读取(查看/纯)
is_contract 检查EVM地址是合约还是EOA

去中心化交易所

工具 说明
dex-get-pools 列出可用的流动性池
dex-find-routes 查找两个令牌之间的交换路由
dex-simulate-swap 模拟交换(无执行)

代币和NFT

工具 说明
get_nft_info 获取ERC721 NFT元数据
check_nft_ownership 检查地址是否拥有特定NFT
get_erc1155_token_uri 获取ERC1155令牌URI
get_erc20_token_info 获取ERC20代币名称、符号、小数、供应

效用

工具 说明
convert_address 在bech32之间转换(mantra1...)EVM(0x...)格式
get_token_supply 获取MANTRA代币的链上供应总量
get_token_price 从CoinGecko获取MANTRA(OM)的当前价格

资源

资源 描述
networks://all 所有可用网络及其配置
openapi://{networkName} 网络的REST API的OpenAPI规范

快速开始

在本地运行(stdio)

npx mantrachain-mcp@latest

本地运行(HTTP)

npx mantrachain-mcp@latest -- --http
# Server starts on http://localhost:3000

从源代码构建

git clone https://github.com/anthropics/mantrachain-mcp.git
cd mantrachain-mcp
npm install
npm run build
npm start          # stdio mode
npm run start-http # HTTP mode

MCP客户端配置

克劳德桌面/光标/克劳德代码(stdio)

添加到MCP客户端配置中:

{
  "mcpServers": {
    "mantrachain": {
      "command": "npx",
      "args": ["-y", "mantrachain-mcp@latest"]
    }
  }
}

Claude Cowork/远程客户端(HTTP)

部署到Cloud Run(或任何主机),然后通过Streamable HTTP端点连接:

https://your-cloud-run-url.run.app/mcp

端点

路径 方法 描述
/mcp POST 流式HTTP MCP端点
/health GET 健康检查(返回200)

码头工人

docker build -t mantrachain-mcp .
docker run -p 3000:3000 mantrachain-mcp

部署到云端运行

# Build and push
gcloud builds submit --tag gcr.io/YOUR_PROJECT/mantrachain-mcp

# Deploy
gcloud run deploy mantrachain-mcp \
  --image gcr.io/YOUR_PROJECT/mantrachain-mcp \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --port 3000

环境变量

变量 必填 描述
CUSTOM_NETWORKS 否 带有其他网络配置的JSON字符串
PORT 无 HTTP端口(默认值: 3000,由Cloud Run自动设置)

自定义网络示例

export CUSTOM_NETWORKS='{"my-net":{"rpcEndpoint":"https://rpc.example.com","apiEndpoint":"https://api.example.com","chainId":"my-net-1","prefix":"custom","denom":"ucustom","gasPrice":"0.01","isMainnet":false}}'

网络

网络 链ID 默认 类型
mantra-1 mantra-1 是 主网
mantra-dukong-1 mantra-dukong-1 否 测试网

许可证

麻省理工学院