3xpl.com JSON API MCP server

3xpl.com JSON API MCP サーバー

概要

Model Context Protocol（MCP）サーバー形式の3xpl APIです。

LLMが48のブロックチェーン上のデータとやり取りできるようにします。

このリポジトリは、3xpl JSON APIの使用例としても利用できます。詳細はコードをご覧ください。

利用可能なツール一覧

name	description	status
resolve_ens_domain	ENSドメインを通常のアドレスに解決します	✅
detect_blockchains	トランザクション／アドレスが存在するブロックチェーンの一覧を取得します	✅
get_latest_block	指定したブロックチェーンの最新ブロック高を取得します	✅
get_average_fee_24h_usd	指定したブロックチェーンにおける過去24時間の平均トランザクション手数料を米ドルで取得します	✅
get_mempool_events_count	指定したブロックチェーンのメモリプールにある、現時点で未確認のイベント（トランザクションではなく、送金、入出力）の数を取得します	✅
get_events_count_24h	指定したブロックチェーンにおける過去24時間のイベント数（トランザクション全体ではなく、送金、入出力）を取得します	✅
get_block_overview	指定したブロックチェーンのブロックの概要を簡潔に取得します	✅
get_address_overview	指定したブロックチェーンのアドレスの概要を簡潔に取得します	✅
get_transaction_overview	指定したブロックチェーンのトランザクションの概要を簡潔に取得します（改善予定）	✅
list_blockchains_and_modules	ブロックチェーンとそのモジュール、およびモジュールの説明の一覧を取得します	✅
aggregate_block_transactions	ブロック内のトランザクションを集計します	✅
aggregate_transaction_transfers	トランザクション内の個別の送金を集計します	✅
aggregate_address_balances	アドレスの残高を集計します	✅
aggregate_address_transactions	アドレスの確認済みトランザクションを集計します	✅
aggregate_address_mempool	アドレスの保留中のトランザクションを集計します	✅

利用可能なプロンプト一覧

name	description
get_blockchain_info	LLMがデータをさらに掘り下げ、より充実した回答を提供できるようにします。

インストール

# get the repository
git clone https://github.com/exekerey/3xpl-mcp.git
cd 3xpl-mcp

# create and activate virtual environment
uv venv 
source .venv/bin/activate

# install dependencies
uv pip install -e .

MCP の設定：

{
  "mcpServers": {
    "3xpl_API": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "{:path_to_cloned}/3xpl_mcp/main.py"
      ],
      "env": {
        "THREEXPL_API_KEY": ""
      }
    }
  }
}

注記 1：3xpl の API キーを設定すると、メイン API を利用できます。 設定ファイルの THREEXPL_API_KEY フィールドが空欄の場合、 MCP サーバーはレート制限のあるサンドボックス API を使用します。

注記 2：MCP サーバーが起動しない場合は、command フィールドに uv のフルパスを指定する必要があることがあります。

コントリビューション

バグや提案については、お気軽に issue を作成してください。
プルリクエストも歓迎します。変更内容の説明を必ず記載してください。