Trading Simulator

Un servidor MCP para interactuar con la API de Trading Simulator y simular actividades de trading.

GitHub

Documentación

Trading Simulator MCP Server

Un servidor MCP (Protocolo de Contexto de Modelo) para interactuar con la API de Trading Simulator. Este servidor permite que modelos de IA como Claude consulten saldos, consulten precios y ejecuten operaciones mediante una interfaz compatible con MCP.

Características

Este servidor MCP proporciona acceso a las operaciones de Trading Simulator a través de llamadas estructuradas a herramientas:

  • Operaciones de Cuenta

    • Consultar saldos de tokens
    • Consultar información de la cartera
    • Ver historial de operaciones

  • Operaciones de Precio

    • Consultar precios de tokens
    • Consultar información de tokens
    • Ver historial de precios

  • Operaciones de Trading

    • Ejecutar operaciones entre tokens
    • Obtener cotizaciones para operaciones potenciales
    • Detección inteligente de tokens que gestiona automáticamente los parámetros de cadena

  • Operaciones de Competencia

    • Consultar el estado de la competencia
    • Ver la clasificación de la tabla de líderes

Uso mediante NPX

Uso de Variables de Entorno en la Configuración de Cursor/Claude/Windsurf

Configura tu archivo JSON de servidores MCP para tu entorno de consumo designado añadiendo este MCP con el siguiente 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"
      }
    }
  }
}

Ejecutándolo desde tu terminal:

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

Herramientas MCP

El servidor proporciona las siguientes herramientas MCP:

Herramientas de Cuenta

  • get_balances - Consulta los saldos de tokens de tu equipo
  • get_portfolio - Consulta la información de la cartera de tu equipo
  • get_trades - Consulta el historial de operaciones de tu equipo

Herramientas de Precio

  • get_price - Consulta el precio actual de un token
  • get_token_info - Consulta información detallada sobre un token
  • get_price_history - Consulta datos históricos de precios de un token

Herramientas de Trading

  • execute_trade - Ejecuta una operación entre dos tokens
    • Detecta y asigna automáticamente los parámetros de cadena para tokens comunes
    • Admite operaciones dentro de la misma cadena sin requerir parámetros de cadena explícitos
    • Retrocede correctamente para escenarios de cadenas cruzadas
  • get_quote - Obtén una cotización para una operación potencial

Herramientas de Competencia

  • get_competition_status - Consulta el estado de la competencia actual
  • get_leaderboard - Consulta la clasificación de la competencia

Tokens Comunes

El sistema incluye una estructura COMMON_TOKENS que asigna direcciones de tokens a sus respectivas cadenas. Esto permite la detección automática de parámetros de cadena al ejecutar operaciones.

Los tokens comunes actuales incluyen:

Solana (SVM)

  • USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  • SOL: So11111111111111111111111111111111111111112

Ethereum (EVM)

  • USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
  • WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Base (EVM)

  • USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  • ETH: 0x4200000000000000000000000000000000000006

Para añadir más tokens comunes, puedes ampliar el objeto COMMON_TOKENS en el archivo types.ts.

Consideraciones de Seguridad

  • Tu clave de API debe mantenerse segura y nunca compartirse ni exponerse en código del lado del cliente
  • Utiliza siempre HTTPS al conectarte a la API en entornos de producción
  • La clave de API tiene acceso completo para ejecutar operaciones, así que protégela adecuadamente