Vestige MCP

Vestige MCP

Construído por GoPlausible e derivado de Algorand MCP.

Uma implementação de servidor Model Context Protocol (MCP) para interagir com a API Vestige, fornecendo análises DeFi abrangentes e acesso a dados para o ecossistema Algorand.

Visão Geral

O Vestige MCP serve como uma ponte entre aplicações habilitadas para MCP e a API Vestige, oferecendo ferramentas para acessar:

• Informações e estatísticas da rede
• Análises de protocolos (Tinyman, Pact, Algofi, etc.)
• Dados de ativos e informações de preços
• Análises de pools e informações de liquidez
• Estatísticas de vaults
• Acompanhamento de saldos
• Monitoramento de transações
• Notas e anotações de mercado

Instalação

Para instalar ou atualizar a implementação do Algorand MCP, clone o repositório, instale as dependências e construa o projeto:

Primeiro verifique se a versão do node é 23.6.1 ou posterior:

node -v

Atualize para 23.6.1 ou posterior se necessário!

Em seguida, verifique se as pastas de contêiner do Claude ou Cursor possuem a pasta mcp-servers (se não, crie uma):

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

Em seguida, clone este repositório na pasta mcp-servers e instale as dependências:

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

E pronto! Agora você pode abrir sua configuração MCP e adicionar o servidor como:

{
  "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"

      }
    }
  }
}

Certifique-se de alterar os caminhos para corresponder aos caminhos do seu sistema local.

Por exemplo, no MACOS e no Claud, o caminho seria algo assim:

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

Estrutura do Projeto

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

Recursos

Análises de Rede

• Visualizar status e estatísticas da rede
• Acompanhar a sincronização da blockchain
• Monitorar o desempenho da rede

Acompanhamento de Protocolos

• Acessar dados dos principais protocolos DeFi
• Acompanhar o Valor Total Bloqueado (TVL)
• Monitorar a atividade e o uso dos protocolos

Análises de Ativos

• Informações abrangentes sobre ativos
• Acompanhamento de preços e histórico
• Métricas de volume e liquidez
• Dados de capitalização de mercado
• Análise de composição de ativos

Dados de Negociação

• Monitoramento de swaps em tempo real
• Dados históricos de negociação
• Gráficos de preços e candles
• Profundidade do livro de ordens

Análises de Pool

• Informações sobre pools de liquidez
• Composição do pool
• Acompanhamento de volume e TVL
• Dados históricos do pool

Desenvolvimento

Iniciando o Servidor

cd packages/server
npm run dev

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de recurso
3. Faça commit das suas alterações
4. Envie para o branch
5. Crie um Pull Request

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.