使用说明

项目简介

Veri5ight 是一个模型上下文协议 (MCP) 服务器，旨在弥合 Claude 等语言模型与以太坊区块链之间的鸿沟。它允许 LLM 通过预定义的工具安全、私密且无速率限制地访问以太坊节点数据，从而实现更智能、更具上下文感知能力的区块链交互。

主要功能点

实时数据访问: 直接连接到您的以太坊节点，获取最新的链上信息。
ERC20 代币支持: 查询任何 ERC20 代币的余额和代理信息。
智能合约信息: 获取合约的详细信息，包括代码大小和 ERC20 相关信息。
交易记录查询: 查看地址的近期交易记录，并解析交易详情。
无速率限制: 直接与自己的节点交互，避免 API 速率限制。
隐私安全: 所有查询都直接发送到您配置的节点，保护数据隐私。

安装步骤

克隆仓库:

git clone https://github.com/5ajaki/veri5ight.git
cd veri5ight

安装依赖: 确保您已安装 Node.js 和 npm。在项目根目录下运行：
```
npm install
```
构建项目:
```
npm run build
```
构建成功后，会在 'dist' 目录下生成 'index.js' 文件。

服务器配置

MCP客户端（例如 Claude 桌面应用）需要配置以下 JSON 对象来连接 Veri5ight 服务器。请根据您的实际安装路径修改 'args' 中的路径。

{
  "mcpServers": {
    "veri5ight": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令，这里使用 node
      "args": ["/absolute/path/to/veri5ight/dist/index.js"] // 启动参数，指向编译后的 index.js 文件，请替换为 Veri5ight 项目 dist 目录中 index.js 文件的绝对路径
    }
  }
}

注意: '/absolute/path/to/veri5ight/dist/index.js' 需要替换为您本地 'veri5ight' 项目 'dist' 目录下 'index.js' 文件的绝对路径。您可以通过 'pwd' 命令（在项目 dist 目录下执行）获取当前目录的绝对路径，然后拼接上 'index.js'。

基本使用方法

配置 Claude 桌面应用: 打开 Claude 桌面应用的设置，找到 MCP 服务器配置，将上述 JSON 配置信息填入。确保服务器名称与 JSON 中的 '"veri5ight"' 一致。
启动 Veri5ight 服务器 (可选): 默认情况下，Veri5ight 配置为随 Claude 桌面应用自动启动。如果您禁用了自动启动，或者需要手动启动服务器，可以在项目根目录下运行：
```
node dist/index.js
```

在 Claude 中使用工具: 在 Claude 中，您可以使用自然语言调用 Veri5ight 提供的工具。以下是一些示例：

查询代币余额:

Claude, vitalik.eth 的 UNI 余额是多少？

查询代币代理信息:

Claude, nick.eth 将代币代理给了谁？

查询合约信息:

Claude, 你能告诉我关于 nick.eth 合约的信息吗？

查询近期交易记录:

Claude, 展示一下 vitalik.eth 最近的交易记录。

Claude 会解析您的指令，调用 Veri5ight 服务器提供的工具，并将结果返回给您。

服务器配置 (环境变量)

Veri5ight 服务器需要配置以太坊节点 URL。复制 '.env.example' 文件为 '.env'，并修改 '.env' 文件中的 'ETH_NODE_URL' 变量为您自己的以太坊节点 URL。

ETH_NODE_URL="http://localhost:8545"  # 请替换为您自己的以太坊节点 URL

调试: 如果遇到问题，可以查看 Claude 的日志文件 ('~/Library/Logs/Claude/mcp*.log') 以获取更多调试信息。

关键词