🔍 Veri5ight

🔍 Veri5ight

你身边友好的 Ethereum 节点耳语者！一个帮助 Claude 与 Ethereum 节点对话的模型上下文协议（MCP）服务。

🌟 这是什么？

Veri5ight 是 Claude 与 Ethereum 节点之间的直接接口，可提供：

• 💰 任意 ERC20 代币的实时余额和委托信息
• 🔎 智能合约信息
• 🚀 直接访问节点，不受速率限制
• 🔒 私密、安全的交互

🚀 快速开始

# Clone the repository
git clone https://github.com/5ajaki/veri5ight.git

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 配置

1. 将 .env.example 复制为 .env：

cp .env.example .env

2. 添加你的 Ethereum 节点 URL（下方为示例——请替换为实际的节点 URL 和端口）：

ETH_NODE_URL="http://localhost:8545"  # Example - replace with your node's URL and port

3. 配置 Claude Desktop：

{
  "mcpServers": {
    "veri5ight": {
      "command": "node",
      "args": ["/absolute/path/to/veri5ight/dist/index.js"] // Local path to the compiled index.js file
    }
  }
}

注意：第 3 步中的路径必须指向本地 dist 目录中编译后的 index.js。运行 npm run build 后会创建此文件。

启动选项

默认情况下，Veri5ight 会随 Claude Desktop App 自动启动。如果你更希望按需运行：

1. 从 package.json 中移除会随 Claude 自动启动的 postbuild 脚本
2. 需要时手动运行：

node dist/index.js

🎮 可用工具

ethereum_getTokenBalance

通过地址或 ENS 名称查询任意 ERC20 代币的余额。

示例：

Claude, what's vitalik.eth's UNI balance?

ethereum_getTokenDelegation

查看任意治理代币的委托信息。

示例：

Claude, who has nick.eth delegated their tokens to?

ethereum_getContractInfo

获取任意智能合约的详细信息。

示例：

Claude, what can you tell me about this contract: nick.eth

ethereum_getRecentTransactions

查看任意地址的近期交易。注意：此函数会扫描最近 10 个区块，查找涉及指定地址的交易。

示例：

Claude, show me any recent transactions for vitalik.eth

此函数最多返回这些区块中找到的指定数量的交易（默认为 3 笔）。如果近期区块中没有找到交易，则会返回空结果。

🔍 调试

查看 Claude 的日志，排查问题：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

💡 为什么直接访问节点？

• 低延迟：直接查询节点，无 API 开销
• 无速率限制：可无限次查询自己的节点
• 隐私：查询只在你与节点之间进行
• 完整访问：可使用完整的 JSON-RPC API
• 实时数据：直接访问最新的区块链状态

🛠️ 开发

# Watch mode for the cool kids
npm run dev

# Build for production
npm run build

🤝 参与贡献

有好点子？发现了 Bug？欢迎提交 PR！只需：

1. Fork 项目
2. 创建分支
3. 编写代码
4. 提交 PR

📜 许可证

MIT——尽情使用！法律条款就不赘述了，详见 LICENSE。

🙏 致谢

• Veri5ight 团队倾注 ❤️ 打造
• 由 Claude 的强大智慧驱动
• 站在 Ethereum 巨人的肩膀上

🆘 需要帮助？

• 🐛 发现 Bug？提交 issue！
• 🤔 有问题？发起讨论！
• 🎉 有酷炫的功能点子？告诉我们！

记住：Veri5ight 就像一把 Ethereum 数据瑞士军刀——只是别用它开瓶子！🍾