Cryptoapis Address History

@cryptoapis-io/mcp-address-history

Crypto APIs のアドレス履歴製品用 MCP サーバーです。同期済みアドレスのブロックチェーン上の全トランザクション履歴を照会できます。

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

機能

• EVM アドレスの完全な履歴を照会します（Ethereum、Ethereum Classic、BSC、Polygon、Tron）
• UTXO アドレスの完全な履歴を照会します（Bitcoin、Bitcoin Cash、Litecoin、Dogecoin、Dash、Zcash）
• アドレスの同期を管理します（有効化、同期、削除、一覧表示）
• タイムスタンプ範囲で照会します
• 大量の結果セット向けのカーソルベースのページネーション

前提条件

この MCP サーバーを使用するには、以下が必要です。

1. Crypto APIs に登録する
2. ダッシュボードからAPI キーを生成する

インストール

npm install @cryptoapis-io/mcp-address-history

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

使用方法

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

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

Claude Desktop

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

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

Cursor

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

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

MCP Inspector

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

n8n

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

   npx @cryptoapis-io/mcp-address-history --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 を使って異なるポートを割り当ててください。

利用可能なツール

manage_address

履歴データにアクセスするための同期済みアドレスを管理します。すべての EVM および UTXO ブロックチェーンに対応しています。

アクション：

アクション	説明
sync	履歴データ用に新しいアドレスを同期します
activate	以前に同期したアドレスを有効化します
delete	同期済みアドレスを削除します
list	同期済みアドレスをすべて一覧表示します

evm_address_history

EVM アドレスの全履歴を照会します（アドレスの同期が必要です）。

アクション：

アクション	説明
get-statistics	アドレスの統計情報を取得します
list-transactions	すべてのトランザクションを一覧表示します
list-transactions-by-timestamp	指定したタイムスタンプ以降のトランザクションを一覧表示します
list-token-transfers	トークンの送金を一覧表示します
list-internal-transactions	内部トランザクションを一覧表示します
list-tokens	アドレスが保有するトークンを一覧表示します

対応ブロックチェーン： ethereum、ethereum-classic、binance-smart-chain、polygon、tron

注： get-statistics と list-transactions-by-timestamp は Ethereum と Ethereum Classic のみ対応しています。その他のアクションは、5 つすべてのブロックチェーンに対応しています。

utxo_address_history

UTXO アドレスの全履歴を照会します（アドレスの同期が必要です）。

アクション：

アクション	説明	ページネーション
get-statistics	アドレスの統計情報を取得します	-
list-transactions	すべてのトランザクションを一覧表示します	カーソル
list-transactions-by-timestamp	指定したタイムスタンプ以降のトランザクションを一覧表示します	カーソル
list-unspent-outputs	未使用の出力（UTXO）を一覧表示します	オフセット

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

ページネーション

ほとんどのエンドポイントではカーソルベースのページネーションを使用します。

// Response
{
  "items": [...],
  "limit": 10,
  "hasMore": true,
  "nextStartingAfter": "abc123"
}

次のリクエストでは、nextStartingAfter の値を startingAfter パラメーターとして使用します。

例外： list-unspent-outputs ではオフセットページネーションを使用します。

// Response
{
  "items": [...],
  "limit": 10,
  "offset": 0,
  "total": 150
}

設定

stdio トランスポートでは、CLI 引数または環境変数を使用して、起動時に API キーを指定してください。HTTP トランスポートでは、リクエストごとに x-api-key ヘッダーで指定することもできます（HTTP API キーモードを参照）。

1. コマンドライン引数（推奨）：

   npx @cryptoapis-io/mcp-address-history --api-key {your_api_key}
   

2. 環境変数：

   export CRYPTOAPIS_API_KEY={your_api_key}
   

CLI 引数

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

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-address-history --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-address-history --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-address-history --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 サーバーを提供しています。API キーを x-api-key ヘッダーで渡してください。インストールは不要です。

ライセンス

MIT