xby-blockchain-data-service

Readme

# xby-blockchain-data-service

DeepSeek Harness (DSH) 的插件：区块链数据服务

Vitruveo MCP Server 是一个为 Vitruveo 网络提供只读区块链服务的模型上下文协议服务器，适用于AI代理访问区块链数据。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **get_core_contracts** — Get core contract addresses
- **get_chain_info** — Get information about an EVM network
- **get_supported_networks** — Get a list of supported EVM networks
- **get_block_by_number** — Get a block by its block number
- **get_latest_block** — Get the latest block from the EVM
- **get_balance** — Get the native token balance (ETH, MATIC, etc.) for an address
- **get_erc20_balance** — Get the ERC20 token balance of an Ethereum address
- **get_token_balance** — Get the balance of an ERC20 token for an address
- **get_transaction** — Get detailed information about a specific transaction by its hash. Includes sender, recipient, value, data, and more.
- **get_transaction_receipt** — Get a transaction receipt by its hash
- **estimate_gas** — Estimate the gas cost for a transaction
- **read_contract** — 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.
- **is_contract** — Check if an address is a smart contract or an externally owned account (EOA)
- **get_token_info** — 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.
- **get_token_balance_erc20** — Get ERC20 token balance for an address
- **get_nft_info** — Get detailed information about a specific NFT (ERC721 token), including collection name, symbol, token URI, and current owner if available.
- **check_nft_ownership** — Check if an address owns a specific NFT
- **get_erc1155_token_uri** — 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.
- **get_nft_balance** — Get the total number of NFTs owned by an address from a specific collection. This returns the count of NFTs, not individual token IDs.
- **get_erc1155_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.

## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-blockchain-data-service
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-blockchain-data-service
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。