injective-mcp-servers

Injective MCP サーバー、スキルガイド

Model-Context-Protocol（MCP）サーバーは、LLM による呼び出しを目的としたツールを公開し、検出を容易にします。 このスキルでは、Injective にとって重要な MCP サーバーのセットアップ方法と使用方法を説明します。

適用するタイミング

• Injective に関する公式情報を検索するときは、Injective Documentation MCP Server を使用してください。
• Injective Mainnet または Testnet でクエリを実行したり、取引したりするときは、Injective MCP Server を使用してください。
• 無期限先物、スポット送金、クロスチェーンブリッジ、raw EVM トランザクションを含む、すべての取引機能を使用するときは、Injective MCP Server を使用してください。

アクティビティ

Injective Documentation MCP Server のセットアップと実行

ホスト型 MCP サーバーを提供しているため、セットアップは不要です。 https://docs.injective.network/mcp に接続するだけで、 ほとんどの MCP クライアントが利用できるストリーミング可能な HTTP エンドポイントが公開されます。

Injective Documentation MCP Server の使用

MCP ツールを呼び出します。

• SearchInjectiveDocs - Injective の公式ドキュメントを検索します。引用を含む検索結果を返します。

参照先：https://docs.injective.network/developers-ai/documentation-mcp.md

Injective MCP Server のセットアップと実行

インストール：

git clone https://github.com/InjectiveLabs/mcp-server injective-mcp-server
cd injective-mcp-server
npm install && npm run build

手動で実行：

INJECTIVE_NETWORK="mainnet" node ./dist/mcp/server.js

Claude Code で実行：

~/.claude/mcp.json またはプロジェクト内の MCP 設定を編集し、以下を追加します。

{
  "mcpServers": {
    "injective": {
      "command": "node",
      "args": ["/path/to/injective-mcp-server/dist/mcp/server.js"],
      "env": {
        "INJECTIVE_NETWORK": "mainnet"
      }
    }
  }
}

Injective MCP Server の使用

MCP ツールを呼び出します。

• wallet_generate - 新しい Injective ウォレットを生成します。アドレスとニーモニックを返します（表示は一度のみ）。
• wallet_import - 16 進数の秘密鍵からウォレットをインポートします。
• wallet_list - ローカルのキーストアにあるすべてのウォレットを一覧表示します（アドレスのみ。鍵は含まれません）。
• wallet_remove - キーストアからウォレットを完全に削除します。
• market_list - 有効な無期限先物市場をすべて一覧表示します。
• market_price - シンボル（例：BTC）で指定した市場の現在のオラクル価格を取得します。
• account_balances - 銀行口座とサブアカウントの残高を取得します。すべてのトークンタイプに対応しています。
• account_positions - 未実現損益を含む、未決済の無期限ポジションを取得します。
• token_metadata - 任意の denom のシンボル、小数桁数、タイプを確認します。
• trade_open - 成行注文でポジションを建てます（Cosmos 署名）。
• trade_close - 成行注文で未決済のポジションを決済します（Cosmos 署名）。
• trade_open_eip712 - EIP-712 Ethereum 署名（MetaMask 対応の鍵）を使用してポジションを建てます。
• trade_close_eip712 - EIP-712 Ethereum 署名（MetaMask 対応の鍵）を使用してポジションを決済します。
• trade_limit_open - 指値注文を出します。
• trade_limit_orders - 未決済の指値注文を一覧表示します。
• trade_limit_close - orderHash で指値注文をキャンセルします。
• trade_limit_states - 注文ハッシュで注文の状態を照会します。
• transfer_send - 別の Injective アドレスにトークンを送信します。
• subaccount_deposit - 銀行口座の残高から取引サブアカウントに入金します。
• subaccount_withdraw - 取引サブアカウントから銀行口座の残高に出金します。
• bridge_withdraw_to_eth - Peggy ブリッジ経由で Ethereum に出金します（約30分。手数料がかかります）。
• bridge_debridge_quote - サポートされている任意のチェーンへの deBridge DLN 見積もりを取得します。読み取り専用です。
• bridge_debridge_send - deBridge DLN 経由で Injective から別のチェーンにトークンをブリッジします。
• evm_broadcast - Injective EVM 上で raw EVM トランザクションをブロードキャストします。

参照先：https://raw.githubusercontent.com/InjectiveLabs/mcp-server/refs/heads/main/README.md

既知の注意点

MCP サーバーを構築または拡張する方、および MetaMask と統合する方にとって重要な調査結果です。

EIP-712 署名（MetaMask）

• V1 ではなく V2 を使用してください。 V1（getEip712TypedData）では、標準に準拠しないドメイン型（文字列としての verifyingContract: "cosmos"、salt: "0"）が使用されます。MetaMask の eth_signTypedData_v4 は、V1 では無効な署名を警告なく生成します。必ず getEip712TypedDataV2 と SIGN_EIP712_V2 を使用してください。
• 手数料オブジェクトは完全に一致させる必要があります。 getEip712TypedDataV2() と createTransaction() には、完全に同じ手数料オブジェクトを渡す必要があります。一方で SDK のデフォルトを使用し、もう一方でカスタム手数料を使用すると、チェーン上で異なる型付きデータが再構築されるため、ハッシュが一致せず、署名の検証に失敗します。
• evmChainId には任意の EVM チェーンを指定できます。 Injective の EIP-712 署名は、MetaMask がどの EVM チェーンに接続されていても機能します。eth_chainId からチェーン ID を読み取り、EIP-712 ドメインと createWeb3Extension の両方に渡してください。

SDK の fromJSON によるスケーリング

• MsgCreateDerivativeMarketOrder.fromJSON は内部で ×10^18 を適用します。 チェーン単位の値（USDT 市場では価格と証拠金にすでに ×10^6 を適用した値）を渡してください。その後、protobuf 用に小数点以下 18 桁が追加されます。渡す値は、price = humanPrice × 10^6、margin = humanMargin × 10^6、quantity = humanQty（クォート通貨の小数桁数によるスケーリングなし）です。

証拠金の計算

• 厳密な最小額より 1～2％多く設定してください。 margin == price × qty × initialMarginRatio と正確に一致する場合、丸め処理によりチェーンで拒否されることがあります。
• 検証には max(oraclePrice, markPrice) を使用してください。 チェーンはオラクル価格とマーク価格のうち高い方を基準に証拠金を検証します。オラクル価格だけで計算した証拠金は、マーク価格がオラクル価格を上回る場合に不足することがあります。
• stakeUsdt は証拠金であり、想定元本ではありません。 Web アプリでは、ユーザーのステークパラメーターは証拠金です。qty = stake × leverage / price であり、notional / price ではありません。

決済注文

• リデュースオンリー注文には margin: '0' を使用してください。 Injective では、個別の isReduceOnly フラグは必要ありません。
• 決済には 1％のスリッページを使用してください。 レバレッジの低いポジションでは、5％のスリッページにより「order price surpasses bankruptcy price」が発生することがあります。

サブアカウントへの入金

• 銀行残高と取引所のサブアカウント残高は異なります。 デリバティブ注文を出す前に、銀行からサブアカウントへ USDT を移動するため、MsgDeposit（または subaccount_deposit ツールの呼び出し）が必要です。必ずサブアカウントの残高を確認し、不足している場合は自動で入金してください。

デプロイ（Express／Web アプリ）

• 正しいサブディレクトリから配信してください。 server.js が dist/ から配信する場合、ビルドしたファイルはプロジェクトのルートではなく dist/ にデプロイしてください。
• HTML にキャッシュなしのヘッダーを設定してください。 HTML のレスポンスに Cache-Control: no-cache, no-store, must-revalidate が設定されていないと、デプロイ後もブラウザーが古い JS バンドルを配信します。

関連スキル

このスキルは、他のスキルを使用せず、依存もしません。

前提条件

Node.js v22 以降が必要です。 node -v で確認してください。