内容
# 维特鲁威 MCP 服务器 (`vtru-mcp`)
一个 **模型上下文协议（MCP）** 服务器，为 **维特鲁威** 网络提供 **只读** 的区块链服务。
> **维特鲁威增强功能：**
> 新增 `get_core_contracts`，返回维特鲁威核心合约地址列表（金库、系统合约等）。
> 更多维特鲁威特定工具将随着时间推移添加。
> **分叉自：** `mcpdotdirect/evm-mcp-server`
---
## 📋 目录
- 概述
- 功能特点
- 维特鲁威工具
- 支持的网络
- 前置条件
- 安装
- 服务器配置
- 使用方法
- 从 MCP 客户端连接
- API 参考
- 项目结构
- 开发
- 许可证
---
## 🔭 概述
`vtru-mcp` 通过模型上下文协议向 AI 代理公开 **维特鲁威链数据**。
设计目标：
- **专注于维特鲁威** – 仅限链 ID 1490。
- **只读** – 无私钥或签名。
- **MCP 原生** – 公开工具和资源。
- **双重传输** – STDIO 和 HTTP/SSE。
---
## ✨ 功能特点
### 区块链数据
- 最新区块检索
- 按编号获取区块
- 交易查询
- 交易收据
- 原生 VTRU 余额
- 合约视图/纯调用
- 代币/NFT 元数据（只读）
### 维特鲁威特定功能
- `get_core_contracts` — 返回维特鲁威系统合约地址。
### 安全且适用于公开使用
- 无私钥
- 无转账或批准
- 无写入方法
---
## 🌐 支持的网络
- **维特鲁威主网**
- 链 ID：1490
- RPC：https://rpc.vitruveo.xyz
- 浏览器：https://explorer.vitruveo.net
---
## 🛠️ 前置条件
- Bun 1.0+
- Node 18+
---
## 📦 安装
```
npm install -g @vitruveo/vtru-mcp
```
或：
```
npx @vitruveo/vtru-mcp
```
从源代码：
```
git clone https://github.com/vitruveo/vtru-mcp.git
cd vtru-mcp
bun install
```
---
## ⚙️ 服务器配置
默认值：
- 链 ID：1490
- RPC：https://rpc.vitruveo.xyz
- 主机：0.0.0.0
- 端口：3001
---
## 🚀 使用方法
### STDIO（默认）
```
npx @vitruveo/vtru-mcp
```
### HTTP + SSE
```
npx @vitruveo/vtru-mcp --http
```
端点：
- SSE：`/sse`
- 消息：`/messages`
---
## 🤖 从 MCP 客户端连接
### Cursor（命令模式）
`.cursor/mcp.json`：
```json
{
"mcpServers": {
"vtru-mcp": {
"command": "npx",
"args": ["@vitruveo/vtru-mcp"]
}
}
}
```
### Cursor（HTTP 模式）
```json
{
"mcpServers": {
"vtru-mcp-http": {
"url": "http://localhost:3001/sse"
}
}
}
```
### ChatGPT 桌面版
- 类型：命令
- 命令：`npx`
- 参数：`@vitruveo/vtru-mcp`
### Claude CLI
```
claude mcp add vtru-mcp npx @vitruveo/vtru-mcp
claude
```
---
## 📚 API 参考
### 工具
| 工具名称 | 描述 |
|---------------------|-------------------------------------------------|
| `get_core_contracts`| 返回维特鲁威系统合约地址列表 |
| `get_chain_info` | 链元数据（chainId、区块、rpc） |
| `get_block` | 按编号或最新区块获取 |
| `get_transaction` | 交易详情 |
| `get_balance` | 原生 VTRU 余额 |
| `is_contract` | 检测地址是否为合约 |
| `read_contract` | 合约视图/纯调用 |
代币/NFT（只读）：
| 工具 | 描述 |
|---------------------|-----------------------------|
| `get-token-info` | ERC20 风格的元数据 |
| `get-token-balance` | ERC20 风格的余额 |
| `get-nft-info` | NFT 元数据 |
| `get-nft-balance` | NFT 余额 |
---
## 📁 项目结构
```
vtru-mcp/
├── app/
│ └── mcp/
│ └── route.js
├── src/
│ └── mcp/
│ ├── chains.ts
│ ├── tools.ts
│ ├── resources.ts
│ └── services/
│ ├── balance.ts
│ ├── blocks.ts
│ ├── clients.ts
│ ├── contracts.ts
│ ├── ens.ts
│ ├── index.ts
│ ├── tokens.ts
│ ├── transactions.ts
│ ├── transfer.ts
│ └── utils.ts
├── bin/cli.js
├── build/
└── package.json
```
---
## 🛠️ 开发
```
bun dev
bun dev:http
bun run build
bun run build:http
```
发布：
```
npm run release
```
---
## 📄 许可证
MIT 许可证 — 请参阅 LICENSE。
