3xpl.com JSON API MCP server

3xpl.com JSON API MCP 服务

概述

以模型上下文协议（MCP）服务的形式提供 3xpl API。

允许大模型与 48 条区块链上的数据进行交互。

此仓库也可以作为 3xpl JSON API 的使用示例，详情请参阅代码。

可用工具列表

名称	描述	状态
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	汇总某个地址的待处理交易	✅

可用提示词列表

名称	描述
get_blockchain_info	让大模型深入挖掘数据，以提供尽可能完整的回复。

安装

# 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：使用主 API 需要设置来自 3xpl 的 API 密钥。 如果配置文件中的 THREEXPL_API_KEY 字段留空， MCP 服务将使用有速率限制的沙盒 API。

注意 2：如果 MCP 服务无法启动，你可能需要在 command 字段中提供 uv 的完整路径。

贡献

欢迎提交问题报告错误或提出建议。
也欢迎提交拉取请求——请务必说明所做的更改。