Vestige MCP

Vestige MCP

Construido por GoPlausible y derivado de Algorand MCP.

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Vestige, que proporciona análisis DeFi completos y acceso a datos para el ecosistema de Algorand.

Descripción general

Vestige MCP actúa como un puente entre aplicaciones habilitadas para MCP y la API de Vestige, ofreciendo herramientas para acceder a:

• Información y estadísticas de la red
• Análisis de protocolos (Tinyman, Pact, Algofi, etc.)
• Datos de activos e información de precios
• Análisis de pools e información de liquidez
• Estadísticas de bóvedas
• Seguimiento de saldos
• Monitoreo de transacciones
• Notas y anotaciones de mercado

Instalación

Para instalar o actualizar la implementación de Algorand MCP, clona el repositorio, instala las dependencias y compila el proyecto:

Primero verifica que la versión de node sea 23.6.1 o posterior:

node -v

¡Actualiza a 23.6.1 o posterior si es necesario!

Luego verifica que las carpetas de contenedor de Claude o Cursor tengan la carpeta mcp-servers (si no existe, créala):

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

Luego clona este repositorio dentro de la carpeta mcp-servers e instala las dependencias:

cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/GoPlausible/vestige-mcp.git
cd vestige-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations

¡Y listo! Ahora puedes abrir tu configuración de MCP y agregar el servidor de la siguiente manera:

{
  "mcpServers": {
    "vestige-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
     ],
      "env": {
        "ALGORAND_NETWORK": "mainnet",
        "ALGORAND_ALGOD_API": "https://mainnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://mainnet-api.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "ITEMS_PER_PAGE": "10"

      }
    }
  }
}

Asegúrate de cambiar las rutas para que coincidan con las rutas de tu sistema local.

Por ejemplo, en MACOS y Claude, la ruta sería algo como esto:

{
  "mcpServers": {
    "vestige-mcp": {
      "command": "node",
      "args": [
        " /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
     ]
    }
  }
}

Estructura del proyecto

vestige-mcp/
├── packages/
│   ├── client/               # Client library for Vestige MCP (Work in Progress)
│   │   ├── src/
│   │   │   ├── env.ts       # Client environment configuration
│   │   │   ├── index.ts     # Client entry point
│   │   │   └── LocalWallet.ts
│   │   └── package.json
│   │
│   └── server/              # MCP server implementation
│       ├── src/
│       │   ├── tools/       # API tool implementations
│       │   │   └── apiManager/
│       │   │       └── vestige/  # Vestige API endpoints
│       │   ├── utils/       # Utility functions
│       │   ├── resources/   # Resource definitions
│       │   ├── env.ts       # Server environment configuration
│       │   └── index.ts     # Server entry point
│       └── package.json

Características

Análisis de red

• Ver el estado y las estadísticas de la red
• Rastrear la sincronización de la cadena de bloques
• Monitorear el rendimiento de la red

Seguimiento de protocolos

• Acceder a datos de los principales protocolos DeFi
• Rastrear el Valor Total Bloqueado (TVL)
• Monitorear la actividad y el uso de los protocolos

Análisis de activos

• Información completa de activos
• Seguimiento de precios e historial
• Métricas de volumen y liquidez
• Datos de capitalización de mercado
• Análisis de composición de activos

Datos de trading

• Monitoreo de swaps en tiempo real
• Datos históricos de operaciones
• Gráficos de precios y velas
• Profundidad del libro de órdenes

Análisis de pools

• Información de pools de liquidez
• Composición de pools
• Seguimiento de volumen y TVL
• Datos históricos de pools

Desarrollo

Iniciar el servidor

cd packages/server
npm run dev

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características
3. Confirma tus cambios
4. Haz push a la rama
5. Crea una Solicitud de Extracción (Pull Request)

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.