Crypto Apis Blockchain Utils

@cryptoapis-io/mcp-utils

Crypto APIs の Utils 製品向け MCP サーバーです。アドレスの検証、未署名トランザクションのデコード、XRP X-Address のエンコード／デコードを行います。

API バージョン： Crypto APIs バージョン 2024-12-12 と互換性があります。

機能

• UTXO ユーティリティ： アドレスの検証、未署名トランザクションの 16 進数データのデコード（bitcoin、bitcoin-cash、litecoin、dogecoin、dash、zcash）
• EVM ユーティリティ： アドレスの検証、未署名トランザクションの 16 進数データのデコード
• XRP ユーティリティ： アドレスの検証、X-Address のデコード、X-Address のエンコード
• アドレスの導出： 同期せずに HD ウォレット（xPub/yPub/zPub）のチェンジアドレスまたは受取アドレスを導出

前提条件

1. Crypto APIs に登録
2. API キーを生成

インストール

npm install @cryptoapis-io/mcp-utils

または、すべての Crypto APIs MCP サーバーをインストールします：npm install @cryptoapis-io/mcp

使用方法

# Run with API key
npx @cryptoapis-io/mcp-utils --api-key YOUR_API_KEY

# Or use environment variable
export CRYPTOAPIS_API_KEY=YOUR_API_KEY
npx @cryptoapis-io/mcp-utils

# HTTP transport (listens on 127.0.0.1; see "Exposing the server beyond localhost")
npx @cryptoapis-io/mcp-utils --transport http --port 3000 --api-key YOUR_API_KEY

Claude Desktop

Claude Desktop の設定ファイルに追加します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "cryptoapis-utils": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-utils"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加します：

{
  "mcpServers": {
    "cryptoapis-utils": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-utils"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP Inspector

npx @modelcontextprotocol/inspector npx @cryptoapis-io/mcp-utils --api-key YOUR_API_KEY

n8n

1. HTTP モードでサーバーを起動します：

   npx @cryptoapis-io/mcp-utils --transport http --port 3000 --api-key YOUR_API_KEY
   

2. n8n のワークフローに AI Agent ノードを追加します
3. Tools の下に MCP Client Tool を追加し、URL に http://localhost:3000/mcp を設定します

Docker での n8n： コンテナ内の localhost はホストマシンを指しません。サーバーを --host 0.0.0.0 と MCP_AUTH_TOKEN を設定して起動し（localhost の外部へのサーバー公開を参照）、URL に http://host.docker.internal:3000/mcp を指定して、MCP Client Tool の認証情報に Authorization: Bearer <token> ヘッダーを追加します。

すべてのサーバーのデフォルトポートは 3000 です。複数のサーバーを実行する場合は、--port で異なるポートを割り当てます。

使用可能なツール

utxo_utils

アクション	説明
validate-address	UTXO アドレスが有効かどうかを確認します。blockchain、network、address が必要です
decode-raw-transaction	未署名トランザクションの 16 進数データをデコードします。blockchain、network、rawTransactionHex が必要です
convert-bitcoin-cash-address	Bitcoin Cash アドレスをレガシー形式と CashAddr 形式の間で変換します。network、address が必要です（Bitcoin Cash 専用。blockchain パラメーターは不要です）

対応ブロックチェーン： bitcoin、bitcoin-cash、litecoin、dogecoin、dash、zcash

evm_utils

アクション	説明
validate-address	EVM アドレスが有効かどうかを確認します。blockchain、network、address が必要です
decode-raw-transaction	未署名トランザクションの 16 進数データをデコードします。blockchain、network、rawTransactionHex が必要です

xrp_utils

アクション	説明
validate-address	XRP アドレスが有効かどうかを確認します。network、address が必要です
decode-x-address	X-Address をクラシックアドレスとタグにデコードします。network、xAddress が必要です
encode-x-address	クラシックアドレスとタグを X-Address にエンコードします。network、classicAddress、addressTag が必要です

derive_addresses

同期せずに HD ウォレット（xPub/yPub/zPub）のチェンジアドレスまたは受取アドレスを導出します。1 回の呼び出しで最大 10 個のアドレスを導出できます。

パラメーター	説明
blockchain	対象のブロックチェーン
network	ネットワーク名
extendedPublicKey	HD ウォレットの xPub/yPub/zPub
addressFormat	アドレス形式（任意）：p2pkh、p2sh、p2wpkh、standard、p2sh-cash、p2pkh-cash、classic、base58
addressesCount	導出するアドレス数。最大 10（任意）
isChange	true の場合はチェンジアドレスを、false の場合は受取／入金アドレスを導出します（任意、UTXO のみ）
startIndex	導出の開始インデックス（任意）

対応ブロックチェーン： bitcoin、bitcoin-cash、litecoin、dogecoin、dash、zcash、ethereum、ethereum-classic、binance-smart-chain、xrp、tron

CLI 引数

引数	説明	デフォルト
--api-key	Crypto APIs の API キー	CRYPTOAPIS_API_KEY 環境変数
--transport	トランスポートの種類：stdio または http	stdio
--host	HTTP ホスト（リモート接続を受け付けるには 0.0.0.0 を使用してください。--api-key で認証トークンを指定する必要があります）	127.0.0.1
--auth-token	呼び出し元が送信する必要のあるベアラートークン（Authorization: Bearer <token>）。MCP_AUTH_TOKEN 環境変数の使用を推奨します	MCP_AUTH_TOKEN 環境変数
--allowed-hosts	ループバック以外にバインドする場合の、カンマ区切りの Host ヘッダー許可リスト	—
--port	HTTP ポート	3000
--path	HTTP パス	/mcp
--stateless	ステートレス HTTP モードを有効にします	false

HTTP API キーモード

HTTP トランスポートを使用する場合、サーバーは 2 つの API キーモードをサポートします。

• --api-key を指定する場合： すべてのリクエストでこのキーを使用します。x-api-key リクエストヘッダーは無視されます。
• --api-key を指定しない場合： 各リクエストには、有効な Crypto APIs キーを含む x-api-key ヘッダーが必要です。これにより、各ユーザーが自身のキーを指定する公開サーバーをホストできます。

# Per-request key mode (multi-tenant)
npx @cryptoapis-io/mcp-utils --transport http --port 3000
# Clients send x-api-key header with each request

サーバーを localhost の外部に公開する

HTTP モードはデフォルトで 127.0.0.1 をリッスンするため、同じマシン上のプロセスだけが接続できます。 他のマシンやコンテナからの接続を受け付けるには、明示的にバインドし、ポートを保護してください。

# Startup-key mode: callers must present the token (the server refuses to start without one)
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
npx @cryptoapis-io/mcp-utils --transport http --host 0.0.0.0 --port 3000 --api-key YOUR_API_KEY \
  --allowed-hosts mcp.internal.example
# Clients send: Authorization: Bearer $MCP_AUTH_TOKEN

# Per-request key mode: no startup key, every request must carry the caller's own x-api-key
npx @cryptoapis-io/mcp-utils --transport http --host 0.0.0.0 --port 3000

--allowed-hosts は、ループバック以外にバインドする場合に Host ヘッダーを制限します（DNS リバインディング対策）。--auth-token よりも MCP_AUTH_TOKEN の使用を推奨します。コマンドライン引数はプロセス一覧に表示されるためです。

Stdio トランスポートでは、起動時に必ず API キーが必要です。

重要：API キーが必要です

警告： 有効な API キーを使用せずにリクエストを送信した場合、または誤った API キーを使用した場合、Crypto APIs エコシステムから IP アドレスがブロックされることがあります。サーバーを起動する前に、必ず有効な API キーが設定されていることを確認してください。

リモート MCP サーバー

Crypto APIs は、https://ai.cryptoapis.io/mcp で HTTP Streamable トランスポート経由ですべてのツールを利用できる公式リモート MCP サーバーを提供しています。x-api-key ヘッダーで API キーを渡してください。インストールは不要です。

ライセンス

MIT