区块链数据服务 — Blockchain 数据服务

区块链数据服务 Vitruveo MCP Server 是一个为 Vitruveo 网络提供只读区块链服务的模型上下文协议服务器，适用于 AI 代理访问区块链数据。 强制要求：API 密钥 此 Skill 必须配置 API 密钥才能使用。首次使用时，如果 .env 中没有 XBY_APIKEY，必须使用 AskUserQuestion 工具向用户询问 API 密钥。拿到用户提供的密钥后，调用 scripts.config.set_api_key(api_key) 保存，然后继续处理。获取 API 密钥：https://xiaobenyang.com 禁止在缺少 API 密钥时自行搜索或编造数据 工作流程（必须遵守） 你（大模型）是路由层，负责理解用户意图、选择工具、提取参数。代码只负责调用 API。 用户输入 → 你选择工具 → 提取该工具需要的参数 → 调用 scripts.tools 中的函数 → 返回结果给用户 步骤 检查 API 密钥：如果 scripts.config.settings.api_key 为空，使用 AskUserQuestion 询问用户，拿到后调用 scripts.config.set_api_key(key) 保存 选择工具：根据用户意图从下方工具列表中选择对应的工具函数 提取参数：根据选中的工具，提取该工具需要的参数 调用工具：使用关键字参数调用 scripts.tools 中的函数，例如 scripts.tools.search_schools(score='520', province='北京', category='综合') 返回结果：将工具返回的 raw 数据整理后展示给用户 工具选择规则 根据用户意图选择对应的工具函数： 用户意图 | 工具函数 Get core contract addresses | scripts.tools.get_core_contracts Get information about an EVM network | scripts.tools.get_chain_info Get a list of supported EVM networks | scripts.tools.get_supported_networks Get a block by its block number | scripts.tools.get_block_by_number Get the latest block from the EVM | scripts.tools.get_latest_block Get the native token balance (ETH, MATIC, etc.) for an address | scripts.tools.get_balance Get the ERC20 token balance of an Ethereum address | scripts.tools.get_erc20_balance Get the balance of an ERC20 token for an address | scripts.tools.get_token_balance Get detailed information about a specific transaction by its hash. Includes sender, recipient, value, data, and more. | scripts.tools.get_transaction Get a transaction receipt by its hash | scripts.tools.get_transaction_receipt Estimate the gas cost for a transaction | scripts.tools.estimate_gas Read data from a smart contract by calling a view/pure function. This doesn't modify blockchain state and doesn't require gas or signing. | scripts.tools.read_contract Check if an address is a smart contract or an externally owned account (EOA) | scripts.tools.is_contract Get comprehensive information about an ERC20 token including name, symbol, decimals, total supply, and other metadata. Use this to analyze any token on EVM chains. | scripts.tools.get_token_info Get ERC20 token balance for an address | scripts.tools.get_token_balance_erc20 Get detailed information about a specific NFT (ERC721 token), including collection name, symbol, token URI, and current owner if available. | scripts.tools.get_nft_info Check if an address owns a specific NFT | scripts.tools.check_nft_ownership Get the metadata URI for an ERC1155 token (multi-token standard used for both fungible and non-fungible tokens). The URI typically points to JSON metadata about the token. | scripts.tools.get_erc1155_token_uri Get the total number of NFTs owned by an address from a specific collection. This returns the count of NFTs, not individual token IDs. | scripts.tools.get_nft_balance Get the balance of a specific ERC1155 token ID owned by an address. ERC1155 allows multiple tokens of the same ID, so the balance can be greater than 1. | scripts.tools.get_erc1155_balance 如果参数不完整，使用 AskUserQuestion 向用户询问缺失的参数。 工具函数说明 scripts.tools.get_core_contracts 工具描述：Get core contract addresses 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 scripts.tools.get_chain_info 工具描述：Get information about an EVM network 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 scripts.tools.get_supported_networks 工具描述：Get a list of supported EVM networks 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 scripts.tools.get_block_by_number 工具描述：Get a block by its block number 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 blockNumber | number | true | | The block number to fetch scripts.tools.get_latest_block 工具描述：Get the latest block from the EVM 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 scripts.tools.get_balance 工具描述：Get the native token balance (ETH, MATIC, etc.) for an address 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 address | string | true | | The wallet address or ENS name (e.g., '0x1234...' or 'vitalik.eth') to check the balance for scripts.tools.get_erc20_balance 工具描述：Get the ERC20 token balance of an Ethereum address 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 address | string | true | | The Ethereum address to check tokenAddress | string | true | | The ERC20 token contract address scripts.tools.get_token_balance 工具描述：Get the balance of an ERC20 token for an address 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 tokenAddress | string | true | | The contract address or ENS name of the ERC20 token (e.g., '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' for USDC or 'uniswap.eth') ownerAddress | string | true | | The wallet address or ENS name to check the balance for (e.g., '0x1234...' or 'vitalik.eth') scripts.tools.get_transaction 工具描述：Get detailed information about a specific transaction by its hash. Includes sender, recipient, value, data, and more. 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 txHash | string | true | | The transaction hash to look up (e.g., '0x1234...') scripts.tools.get_transaction_receipt 工具描述：Get a transaction receipt by its hash 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 txHash | string | true | | The transaction hash to look up scripts.tools.estimate_gas 工具描述：Estimate the gas cost for a transaction 参数定义 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 to | string | true | | The recipient address value | str | true | |