Gexno Web3

io.github.JanzenChen由 GitHub 帳號 JanzenChen 發布v0.1.3更新於 Oct 29, 2026

Free Ethereum wallet profile & NFT metadata MCP tools (no signup).

發布方自己的服務:Web3TV MCP Server

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融

概覽

AI 產生的概覽

免費的唯讀以太坊查詢工具:助理可取得錢包的 ETH 餘額與簡單風險標記,或依合約地址與 tokenId 解析 NFT 中繼資料。

可以做什麼
  • 查詢以太坊錢包:ETH 餘額、是否為合約、外送交易數,以及簡單的風險啟發式標記(ok、new_wallet、contract、eip7702)。
  • 依合約地址加 tokenId 解析 NFT 中繼資料:名稱、描述、圖片連結、IPFS 閘道連結與原始中繼資料 JSON,支援 ERC-721 與 ERC-1155。
  • 兩個工具皆為唯讀,回傳一般 JSON;發生錯誤時以一般工具錯誤回報。
適用情境
適合助理需要快速取得以太坊地址或 NFT 鏈上資訊、又不想註冊 API 金鑰的情境,例如判斷某地址是合約還是帶委派的 EOA,或取得 NFT 的名稱與圖片連結。
執行需求
遠端 Streamable HTTP 端點,無需安裝。可選的 npm 套件以 stdio 提供相同工具,需要 Node.js 20 以上版本。無需 API 金鑰、註冊或連接錢包。GEXNO_API_BASE、GEXNO_TIMEOUT_MS 與 GEXNO_INTERNAL_TOKEN 僅在自架執行個體時才需要。
安裝前請注意
免費額度有短時間突發限流與依 IP 的每日上限。結果有快取(錢包約 60 秒,NFT 中繼資料約 5 分鐘)。risk 欄位只是簡單的啟發式判斷,並非 AML 或風險評分,不應據此做合規判斷。查詢會送往服務商的 API,被查詢的地址會提供給該第三方。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Gexno Web3,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.JanzenChen%2Fgexno-web3/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "gexno-web3": {
      "type": "http",
      "url": "https://api.gexno.com/mcp"
    }
  }
}

README

Gexno Web3 MCP

Free, no-signup on-chain lookups for AI agents. Two read-only tools: wallet profile and NFT metadata.

  • Remote: https://api.gexno.com/mcp — Streamable HTTP, nothing to install
  • npm: npx @gexno/web3-mcp — same tools over stdio
  • Registry name: io.github.JanzenChen/gexno-web3

No API key, no signup, no wallet connection. Reads only.

ToolWhat it returns
lookup_walletETH balance, contract flag, outbound tx count, simple risk heuristics (ok / new_wallet / contract / eip7702)
lookup_nftNFT metadata for contract + tokenId: name, description, image HTTP URL, IPFS gateway link, raw JSON (ERC-721 tokenURI and ERC-1155 uri)

Backed by the Gexno Web3 Agent API: https://api.gexno.com/api/web3

Use it (remote, nothing to install)

json
{  "mcpServers": {    "gexno-web3": {      "url": "https://api.gexno.com/mcp"    }  }}

Works with Claude Desktop, Cursor, and any MCP client that supports remote servers.

Discovery documents:

Use it (npm, stdio)

bash
npx -y @gexno/web3-mcp

Client config:

json
{  "mcpServers": {    "gexno-web3": {      "command": "npx",      "args": ["-y", "@gexno/web3-mcp"]    }  }}

Requires Node.js >= 20. The stdio process calls the same public HTTP API.

Environment variables

VariableDefaultPurpose
GEXNO_API_BASEhttps://api.gexno.comAPI root, useful for self-hosted instances
GEXNO_TIMEOUT_MS35000Per-request timeout; NFT + IPFS resolution can be slow
GEXNO_INTERNAL_TOKEN—Only for self-hosted Gexno APIs that require it. Never commit a value.

Programmatic use

js
import { TOOLS, createApiGet, runTool } from '@gexno/web3-mcp'
const apiGet = createApiGet({ apiBase: 'https://api.gexno.com' })const wallet = await runTool('lookup_wallet', { address: '0xd8dA...6045' }, apiGet)

Use it (local bundle, MCPB)

Download gexno-web3.mcpb from Releases and open it in Claude Desktop (drag onto the app, or Settings → Extensions).

What the output looks like

json
{  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",  "balanceEth": "5.7736",  "isContract": false,  "txCount": 5969,  "risk": "eip7702",  "eip7702": true,  "delegation": { "address": "0xd1ea…", "verified": true }}

EIP-7702 delegated EOAs are reported as risk: "eip7702" with isContract: false — they are still EOAs, they just carry a delegation designator. We parse the 0xef0100 prefix and checksum the delegate address, so a delegated wallet is not misreported as a smart contract.

Limits & behaviour

  • Free tier: short-burst rate limit plus a daily cap per IP; no key required.
  • Cached reads: wallet ~60s, NFT metadata ~5min. Repeat lookups are millisecond-scale.
  • No signup, no tracking, no wallet connection. Reads only.
  • Not an AML/risk score. Heuristics are intentionally simple.
  • Errors surface as normal MCP tool errors; the process does not crash.

Development

bash
npm installnpm run smoke    # live wallet lookup against the APInpm start        # run the stdio server directly

Test against a local API instead of production with GEXNO_API_BASE=http://127.0.0.1:3000.

Security posture and residual risks: HARDENING.md

Links

來源:README.md,提交 6b18695

工具

2

lookup_wallet

Look up an Ethereum wallet

Look up an Ethereum wallet: ETH balance, contract flag, outbound tx count, and simple risk heuristics (ok / new_wallet / contract / eip7702). EIP-7702 delegated EOAs report risk=eip7702. Read-only; not an AML score.

輸入參數address必填

lookup_nft

Look up NFT metadata

Resolve NFT metadata for a contract + tokenId: name, description, image HTTP URL, IPFS gateway link, and raw metadata JSON. Supports ERC-721 and ERC-1155. Read-only.

輸入參數tokenId必填contract必填

版本歷史

1
  1. v0.1.3最新Oct 29, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Web3 整合