🔍 Veri5ight

你友好的以太坊节点耳语者！一个帮助Claude与以太坊节点通信的模型上下文协议（MCP）服务器。

🌟 这是关于什么？

Veri5ight 是 Claude 和以太坊节点之间的直接接口，提供：

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

🚀 快速开始

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

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 配置

将 .env.example 复制到 .env：

cp .env.example .env

添加你的以太坊节点 URL（下面显示的是示例 - 请使用你的实际节点 URL 和端口进行更新）：

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

配置 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 自动启动。如果你更喜欢按需运行：

从 package.json 中删除自动随 Claude 启动的 postbuild 脚本
根据需要手动运行：

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

🤝 贡献

有想法？发现了错误？欢迎提交 PR！只需：

分叉它
创建分支
编写代码
提交 PR

📜 许可证

MIT - 放手去做吧！详见 LICENSE 获取无聊的法律条款。

🙏 致谢

由 Veri5ight 团队用心打造
由 Claude 的大脑驱动
站在以太坊巨人的肩膀上

🆘 需要帮助？

🐛 发现了错误？打开一个问题！
🤔 有问题？发起讨论！
🎉 有很酷的功能想法？让我们听听！

记住：Veri5ight 就像以太坊数据的瑞士军刀 - 只是不要试图用它开瓶子！ 🍾