Mantrachain MCP

🚀 人链 MCP サーバー

このサーバーは、人鎖（Cosmos SDK）ブロックチェーンとの相互作用を可能にするモデルコンテキストプロトコル（MCP）サーバーです。MCP プロトコルを使用して、トークンの送信、バリデーターノードへの委任、残高の照会などの機能を提供します。

🚀 クイックスタート

mantrachain-mcp-server は、Node.js ベースのツールで、MCP プロトコルを介したブロックチェーンネットワークとの相互作用をサポートします。これは、さまざまなブロックチェーンプロトコルとアプリケーションに適した柔軟で強力なフレームワークを提供します。

✨ 主な機能

• 他のアドレスへのトークン送信（銀行振込）
• バリデーターノードへのトークン委任（ステーキング）
• アカウント残高の照会
• バリデーターノード情報の取得
• 任意のトランザクションの署名とブロードキャスト
• 環境変数を使用したニーモニックとネットワークの構成
• Dukong テストネットとメインネットの選択
• 標準入出力と HTTP+SSE の 2 つの伝送モードをサポート

📦 インストール

グローバルインストール（推奨）

npm を使用してグローバルにインストールします。

npm install -g mantrachain-mcp-server

ローカルビルド

ソースコードからビルドする場合は、以下のコマンドを実行します。

git clone [リポジトリアドレス]
cd mantrachain-mcp-server
npm install

💻 使用例

基本的な使用法

# トークンの送信
mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000

# 残高の照会
mantrachain-mcp-server query balance --address my_address

# バリデーターノードへの委任
mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000

高度な使用法

# カスタムコマンドの定義（設定ファイル `config/plugins.js`）
module.exports = {
  plugins: [
    {
      name: 'custom-plugin',
      description: 'Custom transaction handler',
      handlers: {
        'tx-custom': {
          method: 'handleCustomTx'
        }
      }
    }
  ]
}

📚 ドキュメント

参考ドキュメント

• コア設定
• プラグインシステム
• コマンドラインインターフェース

チュートリアル

• クイックスタート
• 高度なトピック
• カスタムネットワーク

🔧 技術詳細

提供されているツール

銀行操作

• 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-interact：スマートコントラクトとやり取りします。
• contract-deploy：スマートコントラクトをデプロイします。

その他のツール

• keygen：ニーモニックとキーペアを生成します。
• mnemonic-backup：ニーモニックをバックアップします。
• tx-signer：トランザクション署名ツールです。

環境変数

• MNEMONIC：必須。ウォレットのシードフレーズです。
• CUSTOM_NETWORKS：オプション。追加のネットワーク構成を含む JSON 文字列です。

設定ファイル

コア設定（config/core.js）

module.exports = {
  mnemonic: process.env.MNEMONIC,
  networks: {
    mainnet: {
      chainId: 'main-chain-1',
      rpcUrl: 'https://main.rpc.provider'
    },
    testnet: {
      chainId: 'test-chain-1',
      rpcUrl: 'http://localhost:26657'
    }
  }
}

プラグイン設定（config/plugins.js）

module.exports = {
  plugins: [
    {
      name: 'eth-wallet',
      description: 'Ethereum wallet integration',
      handlers: {
        'query-balance': {
          method: 'getBalance'
        }
      }
    }
  ]
}

📄 ライセンス

詳細なライセンス情報は提供されていません。

チュートリアル

レッスン 1：インストールと設定

1. MCP サーバーをインストールします。

npm install -g mantrachain-mcp-server

2. 環境変数を設定します。

export MNEMONIC="your_mnemonic_phrase"

3. サーバーを起動します。

mantrachain-mcp-server start

レッスン 2：ウォレットの使用

1. アドレスを生成します。

mantrachain-mcp-server wallet generate-address --mnemonic your_mnemonic

2. トークンを送信します。

mantrachain-mcp-server tx send --from my_wallet --to recipient_address --amount 1000

レッスン 3：ステーキングと委任

1. バリデーターノードを照会します。

mantrachain-mcp-server query validators

2. 指定されたノードに委任します。

mantrachain-mcp-server tx delegate --from my_wallet --validator validator_address --amount 2000

貢献ガイド

コミュニティからの貢献を歓迎します！開発への参加方法については、貢献ガイド を参照してください。

mantrachain-mcp-server をご利用いただき、ありがとうございます。ご意見とご協力をお待ちしています。