Veri5ight

Un servidor MCP que permite la interacción basada en chat con nodos de Ethereum.

GitHub
1
Prueba este MCPPatrocinado

Documentación

🔍 Veri5ight

¡Tu susurrador de nodos Ethereum amigable del vecindario! Un servidor de Protocolo de Contexto de Modelo (MCP) que ayuda a Claude a conversar con nodos Ethereum.

🌟 ¿De qué trata todo esto?

Veri5ight es una interfaz directa entre Claude y los nodos Ethereum, que proporciona:

  • 💰 Información en tiempo real de saldos de tokens y delegación para cualquier ERC20
  • 🔎 Información de contratos inteligentes
  • 🚀 Acceso directo al nodo sin límites de tasa
  • 🔒 Interacciones privadas y seguras

Veri5ight Server MCP server

🚀 Inicio rápido

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

# Install dependencies
npm install

# Build the project
npm run build

⚙️ Configuración

  1. Copia .env.example a .env:
cp .env.example .env
  1. Añade la URL de tu nodo Ethereum (ejemplo abajo - actualiza con la URL y el puerto reales de tu nodo):
ETH_NODE_URL="http://localhost:8545"  # Example - replace with your node's URL and port
  1. Configura Claude Desktop:
{
  "mcpServers": {
    "veri5ight": {
      "command": "node",
      "args": ["/absolute/path/to/veri5ight/dist/index.js"] // Local path to the compiled index.js file
    }
  }
}

Nota: La ruta en el paso 3 debe apuntar al index.js compilado en tu directorio local dist. Esto se crea cuando ejecutas npm run build.

Opciones de lanzamiento

Por defecto, Veri5ight se lanza automáticamente con la aplicación Claude Desktop. Si prefieres ejecutarlo bajo demanda:

  1. Elimina el script postbuild de package.json que se auto-lanza con Claude
  2. Ejecuta manualmente cuando sea necesario:
node dist/index.js

🎮 Herramientas disponibles

ethereum_getTokenBalance

Obtén el saldo de tokens para cualquier token ERC20 usando dirección o nombre ENS.

Ejemplo:

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

ethereum_getTokenDelegation

Consulta la información de delegación para cualquier token de gobernanza.

Ejemplo:

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

ethereum_getContractInfo

Obtén información detallada sobre cualquier contrato inteligente.

Ejemplo:

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

ethereum_getRecentTransactions

Consulta transacciones recientes para cualquier dirección. Nota: Esta función escanea los 10 bloques más recientes en busca de transacciones que involucren la dirección especificada.

Ejemplo:

Claude, show me any recent transactions for vitalik.eth

La función devolverá hasta el número solicitado de transacciones (por defecto 3) encontradas dentro de esos bloques. Si no se encuentran transacciones en los bloques recientes, devolverá un resultado vacío.

🔍 Depuración

Revisa los registros de Claude para cualquier problema:

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

💡 ¿Por qué acceso directo al nodo?

  • Baja latencia: Consultas directas al nodo sin sobrecarga de API
  • Sin límites de tasa: Consultas ilimitadas a tu propio nodo
  • Privacidad: Las consultas permanecen entre tú y tu nodo
  • Acceso completo: Disponibilidad total de la API JSON-RPC
  • Datos en tiempo real: Acceso directo al estado más reciente de la blockchain

🛠️ Desarrollo

# Watch mode for the cool kids
npm run dev

# Build for production
npm run build

🤝 Contribuciones

¿Tienes ideas? ¿Encontraste un error? ¡Las solicitudes de extracción (PR) son bienvenidas! Solo:

  1. Haz un fork
  2. Crea una rama
  3. Escribe el código
  4. Envía el PR

📜 Licencia

MIT - ¡Libre! Consulta LICENCIA para los aburridos asuntos legales.

🙏 Agradecimientos

  • Hecho con ❤️ por el equipo de Veri5ight
  • Impulsado por el gran cerebro de Claude
  • Sobre los hombros de los gigantes de Ethereum

🆘 ¿Necesitas ayuda?

  • 🐛 ¿Encontraste un error? ¡Abre un issue!
  • 🤔 ¿Preguntas? ¡Inicia una discusión!
  • 🎉 ¿Idea genial? ¡Cuéntanosla!

Recuerda: Veri5ight es como una navaja suiza para los datos de Ethereum, ¡solo que no intentes abrir botellas con ella! 🍾