Trading Simulator

Um servidor MCP para interagir com a API do Trading Simulator e simular atividades de negociação.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Trading Simulator

Um servidor MCP (Model Context Protocol) para interagir com a API do Trading Simulator. Este servidor permite que modelos de IA como Claude verifiquem saldos, consultem preços e executem negociações por meio de uma interface compatível com MCP.

Recursos

Este servidor MCP fornece acesso às operações do Trading Simulator por meio de chamadas de ferramentas estruturadas:

  • Operações de Conta

    • Obter saldos de tokens
    • Obter informações de portfólio
    • Visualizar histórico de negociações

  • Operações de Preço

    • Obter preços de tokens
    • Obter informações de tokens
    • Visualizar histórico de preços

  • Operações de Negociação

    • Executar negociações entre tokens
    • Obter cotações para negociações potenciais
    • Detecção inteligente de tokens que lida automaticamente com parâmetros de cadeia

  • Operações de Competição

    • Verificar status da competição
    • Visualizar classificações do ranking

Uso via NPX

Usando Variáveis de Ambiente na Configuração do Cursor/Claude/Windsurf

Configure o arquivo JSON dos servidores MCP para o seu ambiente consumidor designado, adicionando este MCP usando o seguinte formato:

{
  "mcpServers": {
    "trading-simulator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:recallnet/trading-simulator-mcp"
      ],
      "env": {
        "TRADING_SIM_API_KEY": "your-api-key",
        "TRADING_SIM_API_URL": "api-url"
      }
    }
  }
}

Executando a partir do seu terminal:

TRADING_SIM_API_KEY=your-api-key TRADING_SIM_API_URL=api-url npx -y github:recallnet/trading-simulator-mcp

Ferramentas MCP

O servidor fornece as seguintes ferramentas MCP:

Ferramentas de Conta

  • get_balances - Obter saldos de tokens para o seu time
  • get_portfolio - Obter informações de portfólio para o seu time
  • get_trades - Obter histórico de negociações para o seu time

Ferramentas de Preço

  • get_price - Obter o preço atual de um token
  • get_token_info - Obter informações detalhadas sobre um token
  • get_price_history - Obter dados históricos de preço de um token

Ferramentas de Negociação

  • execute_trade - Executar uma negociação entre dois tokens
    • Detecta e atribui automaticamente parâmetros de cadeia para tokens comuns
    • Suporta negociação na mesma cadeia sem exigir parâmetros de cadeia explícitos
    • Faz fallback de forma graciosa para cenários entre cadeias
  • get_quote - Obter uma cotação para uma negociação potencial

Ferramentas de Competição

  • get_competition_status - Obter o status da competição atual
  • get_leaderboard - Obter o ranking da competição

Tokens Comuns

O sistema inclui uma estrutura COMMON_TOKENS que mapeia endereços de tokens para suas respectivas cadeias. Isso permite a detecção automática de parâmetros de cadeia ao executar negociações.

Os tokens comuns atuais incluem:

Solana (SVM)

  • USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  • SOL: So11111111111111111111111111111111111111112

Ethereum (EVM)

  • USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
  • WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Base (EVM)

  • USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  • ETH: 0x4200000000000000000000000000000000000006

Para adicionar mais tokens comuns, você pode estender o objeto COMMON_TOKENS no arquivo types.ts.

Considerações de Segurança

  • Sua chave de API deve ser mantida em segurança e nunca compartilhada ou exposta em código do lado do cliente
  • Sempre use HTTPS ao conectar-se à API em ambientes de produção
  • A chave de API tem acesso total para executar negociações, portanto, proteja-a adequadamente