JinDaGe - 3xpl-mcp MCP Details

article

README

🚀 3xpl.com JSON API MCP 服务器

本项目是一个以 Model Context Protocol (MCP) 形式呈现的 3xpl API 示例实现，它允许大语言模型（LLM）与 48 条区块链上的数据进行交互。此仓库还可作为 3xpl JSON API 使用的示例，具体细节可在代码中查看。

🚀 快速开始

本项目允许 LLM 与 48 条区块链上的数据交互，以下为你提供详细的安装和配置步骤。

📦 安装指南

克隆仓库并进入项目目录

# 克隆仓库
git clone https://github.com/exekerey/3xpl-mcp.git
cd 3xpl-mcp

创建并激活虚拟环境

uv venv 
source .venv/bin/activate

安装依赖项

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": ""
      }
    }
  }
}

⚠️ 重要提示

请从 3xpl 获取您的 API 密钥以使用主 API。如果配置文件中的 THREEXPL_API_KEY 字段留空，MCP 服务器将使用 sandbox API，该 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 | 使 LLM 深入挖掘数据，以提供最全面的回答。 |

⚠️ 注意事项

⚠️ 重要提示

如果您遇到任何问题，请确保按照步骤正确设置环境和依赖项。

确保 API 密钥安全，不要将其公开或分享给他人。

3xpl-mcp