Gexno Web3

Gexno Web3 MCP

AI エージェント向けの、無料で登録不要なオンチェーン情報の検索機能です。読み取り専用のツールを2つ利用できます。ウォレットプロフィールとNFT メタデータです。

• リモート： https://api.gexno.com/mcp — Streamable HTTP。インストール不要です
• npm： npx @gexno/web3-mcp — stdio 経由で同じツールを利用できます
• レジストリ名： io.github.JanzenChen/gexno-web3

API キー、登録、ウォレット接続は不要です。読み取り専用です。

ツール	返される情報
lookup_wallet	ETH 残高、コントラクトフラグ、送信 tx 数、シンプルなリスク判定（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 は、isContract: false のまま risk: "eip7702" として報告されます。委譲デジグネーターを保持しているだけで、引き続き EOA です。0xef0100 プレフィックスを解析し、委譲先アドレスのチェックサムを計算するため、委譲されたウォレットがスマートコントラクトとして誤って報告されることはありません。

制限と動作

• 無料プランでは、短時間のレート制限と IP ごとの1日あたりの上限があります。キーは不要です。
• 読み取り結果をキャッシュします：ウォレットは約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