mcp-address-latest

@cryptoapis-io/mcp-address-latest

Crypto APIs Address Latest 製品向けの MCP サーバーです。アドレスの同期を必要とせず、最近のブロックチェーンアドレスデータ（過去 14 日間）を照会できます。

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

特長

• EVM アドレスを照会できます（Ethereum、Ethereum Classic、BSC、Polygon、Avalanche（C-Chain）、Arbitrum、Base、Optimism、Tron）。
• UTXO アドレスを照会できます（Bitcoin、Bitcoin Cash、Litecoin、Dogecoin、Dash、Zcash）。
• Solana アドレスを照会できます（SOL 残高、トランザクション、SPL トークン）。
• XRP/Ripple アドレスを照会できます（残高、トランザクション、シーケンス）。
• Kaspa アドレスを照会できます（残高、トランザクション）。
• 大規模な結果セットに対応したカーソルベースのページネーション。
• アドレスの同期は不要です（Address History とは異なります）。

前提条件

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

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

インストール

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

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

使用方法

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

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

Claude Desktop

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

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

Cursor

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

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

MCP Inspector

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

n8n

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

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

使用可能なツール

evm_address_latest

最新の EVM アドレスデータを照会します。

アクション：

アクション	説明
get-balance	アドレスの残高を取得します
get-next-nonce	次に使用可能な nonce を取得します。対応：Ethereum（mainnet、sepolia）、Ethereum Classic（mainnet、mordor）、BSC（mainnet、testnet）
list-transactions	アドレスのトランザクションを一覧表示します
list-token-transfers	トークンの送金を一覧表示します（ERC-20、ERC-721、ERC-1155）
list-internal-transactions	内部トランザクションを一覧表示します

対応ブロックチェーン： ethereum、ethereum-classic、binance-smart-chain、polygon、avalanche（C-Chain）、arbitrum、base、optimism、tron

utxo_address_latest

最新の UTXO アドレスデータを照会します。

アクション：

アクション	説明
get-balance	アドレスの残高を取得します
list-transactions	アドレスのトランザクションを一覧表示します
list-unconfirmed-transactions	未承認のトランザクション（メンプール）を一覧表示します。オフセットベースのページネーションを使用します

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

solana_address_latest

最新の Solana アドレスデータを照会します。

アクション：

アクション	説明
get-balance	アドレスの SOL 残高を取得します
list-transactions	アドレスのトランザクションを一覧表示します
list-tokens	アドレスが保有する SPL トークンを一覧表示します

対応ネットワーク： mainnet、devnet

xrp_address_latest

最新の XRP（Ripple）アドレスデータを照会します。

アクション：

アクション	説明
get-balance	アドレスの XRP 残高を取得します
list-transactions	アドレスのトランザクションを一覧表示します
get-next-sequence	次に使用可能なシーケンス番号を取得します

対応ネットワーク： mainnet、testnet

kaspa_address_latest

最新のKaspaアドレスデータを照会します。

アクション：

アクション	説明
get-balance	アドレスのKAS残高を取得します
list-transactions	アドレスのトランザクションを一覧表示します

対応ネットワーク： mainnet

ページネーション

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

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

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

例外： list-unconfirmed-transactions（UTXO）では、limit、offset、totalフィールドを使用するオフセットベースのページネーションを使用します。

設定

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

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

   npx @cryptoapis-io/mcp-address-latest --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	呼び出し元が送信する必要のあるBearerトークン（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-latest --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-latest --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-latest --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