MantraChain MCP 服务器
用于与 MantraChain(Cosmos SDK)区块链交互的模型上下文协议 (MCP) 服务器。该服务器提供使用 MCP 协议发送代币、委托给验证者、查询余额等功能。
特征
- 将代币发送到其他地址(银行发送)
- 将代币委托给验证者(质押)
- 查询账户余额
- 获取验证者信息
- 签署并广播任意交易
- 通过环境变量配置助记词和网络
- 在 Dukong 测试网和主网之间进行选择
- 支持 stdio 和 HTTP+SSE 传输模式
可用工具
银行业务
- 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 规范
运行服务器
服务器可以以两种模式运行:
- **Stdio 模式(默认):**通过标准输入/输出进行通信。这是直接运行服务器或通过
npx
运行服务器时的默认模式。# Using installed package
mantrachain-mcp
# Using npx
npx -y mantrachain-mcp@latest
- **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
替换为构建目录的实际路径。
然后,您可以使用以下配置:
{
"mcpServers": {
"mantrachain-mcp": {
"command": "node",
"args": [
"your_path/mantrachain-mcp/build/index.js"
],
"env": {
"MNEMONIC": "YOUR_MNEMONIC"
}
}
}
}
环境变量
- MNEMONIC :必填。钱包使用的助记词种子短语。
- CUSTOM_NETWORKS :可选。包含附加网络配置的 JSON 字符串。