Gexno Web3

Gexno Web3 MCP

为 AI Agent 提供免费、无需注册的链上查询。包含两个只读工具：钱包资料和 NFT 元数据。

• 远程服务： https://api.gexno.com/mcp — Streamable HTTP，无需安装
• npm： npx @gexno/web3-mcp — 通过 stdio 使用相同的工具
• 注册表名称： io.github.JanzenChen/gexno-web3

无需 API 密钥、无需注册、无需连接钱包。仅供读取。

工具	返回内容
lookup_wallet	ETH 余额、合约标记、出站交易计数、简单风险启发式结果（ok / new_wallet / contract / eip7702）
lookup_nft	合约 + tokenId 对应的 NFT 元数据：名称、描述、图片 HTTP URL、IPFS 网关链接、原始 JSON（ERC-721 tokenURI 和 ERC-1155 uri）

由 Gexno Web3 Agent API 提供支持：https://api.gexno.com/api/web3

使用方法（远程，无需安装）

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

适用于 Claude Desktop、Cursor，以及任何支持远程服务的 MCP 客户端。

发现文档：

• 服务卡片 — https://api.gexno.com/.well-known/mcp/server-card.json
• AI 目录 — https://api.gexno.com/.well-known/ai-catalog.json
• OpenAPI — https://api.gexno.com/api/web3/openapi.json

使用方法（npm，stdio）

npx -y @gexno/web3-mcp

客户端配置：

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

需要 Node.js >= 20。stdio 进程会调用相同的公共 HTTP API。

环境变量

变量	默认值	用途
GEXNO_API_BASE	https://api.gexno.com	API 根地址，可用于自托管实例
GEXNO_TIMEOUT_MS	35000	每次请求的超时时间；NFT + IPFS 解析可能较慢
GEXNO_INTERNAL_TOKEN	—	仅用于需要此令牌的自托管 Gexno API。切勿提交令牌值。

编程方式使用

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)

使用方法（本地包，MCPB）

从 Releases 下载 gexno-web3.mcpb，并在 Claude Desktop 中打开（拖到应用上，或选择 Settings → Extensions）。

输出示例

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

EIP-7702 委托 EOA 会报告为 risk: "eip7702"，且 isContract: false——它们仍然是 EOA，只是携带了委托标识符。我们会解析 0xef0100 前缀并对委托地址进行校验和处理，因此不会将委托钱包误报为智能合约。

限制与行为

• 免费套餐：短时突发速率限制，并设有每个 IP 的每日上限；无需密钥。
• 读取结果会缓存：钱包约 60 秒，NFT 元数据约 5 分钟。重复查询只需毫秒级时间。
• 无需注册、无跟踪、无需连接钱包。仅供读取。
• 不是 AML/风险评分。启发式规则刻意保持简单。
• 错误会作为常规 MCP 工具错误呈现；进程不会崩溃。

开发

npm install
npm run smoke    # live wallet lookup against the API
npm start        # run the stdio server directly

如需使用本地 API 而非生产环境进行测试，请设置 GEXNO_API_BASE=http://127.0.0.1:3000。

安全状况与剩余风险：HARDENING.md

链接

• 网站 — https://www.gexno.com
• 信任报告 — https://verifymcp.io/servers/janzenchen-gexno-web3/api
• 问题反馈 — https://github.com/JanzenChen/gexno-web3/issues
• 许可证 — MIT