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可网页运行网页搜索与抓取金融

服务详情

标识符: io.github.JanzenChen/gexno-web3
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Oct 29, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 JanzenChen。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.JanzenChen%2Fgexno-web3.svg)](https://sourceweft.com/mcp/io.github.JanzenChen%2Fgexno-web3?utm_source=readme&utm_medium=badge)

概览

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 中

打开控制台中的 Gexno Web3，将其添加到工作区。
为需要使用其工具的对话启用该服务。

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.

Tool	What it returns
`lookup_wallet`	ETH balance, contract flag, outbound tx count, simple risk heuristics (`ok` / `new_wallet` / `contract` / `eip7702`)
`lookup_nft`	NFT 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)

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

Discovery documents:

server card — https://api.gexno.com/.well-known/mcp/server-card.json
AI catalog — https://api.gexno.com/.well-known/ai-catalog.json
OpenAPI — https://api.gexno.com/api/web3/openapi.json

Use it (npm, stdio)

Client config:

json

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

{  "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

Variable	Default	Purpose
`GEXNO_API_BASE`	`https://api.gexno.com`	API root, useful for self-hosted instances
`GEXNO_TIMEOUT_MS`	`35000`	Per-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

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)

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

{  "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

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

工具

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必填