Mantrachain Mcp

MantraChain MCP サーバー

MantraChain（Cosmos SDK）ブロックチェーンと連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、MCP プロトコルを使用して、トークンの送信、バリデーターへの委任、残高の照会などを行うツールを提供します。

機能

• 他のアドレスへのトークン送信（銀行送金）
• バリデーターへのトークン委任（ステーキング）
• アカウント残高の照会
• バリデーター情報の取得
• 任意のトランザクションへの署名とブロードキャスト
• 環境変数を使用したニーモニックとネットワークの設定
• Dukong テストネットと Mainnet の選択
• stdio と HTTP+SSE の両方のトランスポートモードに対応

利用可能なツール

銀行操作

• bank-send：別のアドレスへのトークン送信（1 回のトランザクションで複数のコインに対応）
• 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：2 つのトークン間で利用可能なスワップルートを検索
• dex-simulate-swap：トークンスワップを実行せずにシミュレーションし、予想結果を取得
• dex-swap：スリッページ保護付きで DEX のトークンスワップを実行

トランザクション操作

• sign-and-broadcast：汎用 Cosmos トランザクションに署名してブロードキャスト
• get_transaction：ハッシュを指定して特定の EVM トランザクションの詳細情報を取得
• get_transaction_receipt：ハッシュを指定して EVM トランザクションレシートを取得
• estimate_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 仕様

サーバーの実行

サーバーは次の 2 つのモードで実行できます。

1. Stdio モード（デフォルト）： 標準入力／出力を介して通信します。サーバーを直接実行する場合、または npx を介して実行する場合のデフォルトモードです。

   # インストール済みパッケージを使用
   mantrachain-mcp
   
   # npx を使用
   npx -y mantrachain-mcp@latest
   
   

2. ストリーム可能な HTTP モード： ポート 3000 で HTTP サーバーを実行し、Server-Sent Events（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 経由で MantraChain MCP Server を Claude Desktop に自動インストールするには：

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 文字列です。