Servidor MCP del simulador de comercio

Un servidor MCP (Protocolo de Contexto de Modelo) para interactuar con la API del Simulador de Trading. Este servidor permite a los modelos de IA como Claude consultar saldos, consultar precios y ejecutar operaciones mediante una interfaz compatible con MCP.

Características

Este servidor MCP proporciona acceso a las operaciones del Simulador de Comercio a través de llamadas a herramientas estructuradas:

• Operaciones de cuenta
  • Obtener saldos de tokens
  • Obtener información de la cartera
  • Ver historial de operaciones
• Operaciones de precios
  • Obtener precios de tokens
  • Obtener información del token
  • Ver historial de precios
• Operaciones comerciales
  • Ejecutar transacciones entre tokens
  • Obtenga cotizaciones para posibles operaciones
  • Detección inteligente de tokens que gestiona automáticamente los parámetros de la cadena
• Operaciones de competencia
  • Consultar el estado de la competición
  • Ver la clasificación de la tabla de clasificación

Manejo inteligente de tokens

El Simulador de Trading MCP incluye un sistema de detección de tokens inteligente que simplifica la ejecución de operaciones:

• Detección automática de cadena : al ejecutar transacciones con tokens comunes, el sistema identifica automáticamente la cadena de bloques adecuada (EVM/SVM) y los parámetros de cadena específicos (ETH, BASE, etc.).
• Optimización de la misma cadena : al intercambiar tokens en la misma cadena, los parámetros se configuran automáticamente para las transacciones de la misma cadena.
• Retorno entre cadenas : si un intercambio dentro de la misma cadena falla debido a que los tokens se encuentran en cadenas diferentes, el sistema recurre elegantemente a parámetros explícitos o a la detección del lado del servidor.
• Compatibilidad con tokens comunes : el sistema incluye una lista creciente de tokens comunes con sus direcciones e información de la cadena.

Autenticación

La API de Trading Simulator utiliza autenticación de token de portador, lo que requiere una única clave API pasada en el encabezado Authorization como token de portador.

Ejemplo:

Configuración

1. Clonar el repositorio
   git clone https://github.com/yourusername/trading-simulator-mcp.git cd trading-simulator-mcp
2. Instalar dependencias
   npm install
3. Configure sus credenciales de API (consulte la sección Configuración a continuación)
4. Construir el proyecto
   npm run build
5. Iniciar el servidor
   npm run start

Configuración

Tiene dos opciones para configurar el servidor MCP de Trading Simulator:

Método 1: Configuración directa en Cursor/Claude (recomendado)

El enfoque recomendado es proporcionar variables de entorno directamente en la configuración de Cursor o Claude Desktop. Esto es más seguro y elimina la necesidad de un archivo .env.

• El servidor utilizará automáticamente estas variables de entorno cuando se proporcionen a través de la configuración.
• Consulte las secciones "Agregar al cursor" y "Agregar al escritorio de Claude" a continuación para obtener instrucciones de configuración específicas.

Método 2: Usar un archivo .env (respaldo)

Si prefiere utilizar un archivo .env o está ejecutando el servidor directamente desde la línea de comando:

1. Crea un archivo .env con tus credenciales de API
   cp .env.example .env
2. Edite el archivo .env con su clave API
   TRADING_SIM_API_KEY=your_api_key_here TRADING_SIM_API_URL=http://localhost:3000 DEBUG=false
3. Proteja su archivo .env con permisos restringidos
   chmod 600 .env

Precedencia de variables ambientales

El servidor MCP de Trading Simulator utiliza el siguiente orden de precedencia para las variables de entorno:

1. Variables de entorno proporcionadas directamente desde la configuración JSON
2. Variables de entorno de un archivo .env (si está presente y el número 1 no está disponible)
3. Valores predeterminados para variables opcionales (por ejemplo, API_URL tiene como valor predeterminado " http://localhost:3000 ")

Agregar al cursor

Para agregar este servidor MCP a Cursor:

1. Primero construya el proyecto con npm run build
2. En Cursor, vaya a Configuración > Servidores MCP
3. Haga clic en "Agregar servidor"
4. Configure el servidor con los siguientes ajustes:
   • Nombre : Trading Simulator MCP (o cualquier nombre que prefieras)
   • Tipo : command
   • Comando : node
   • Argumentos : /path/to/trading-sim-mcp/dist/index.js (use la ruta completa)
   • Variables de entorno :
     • TRADING_SIM_API_KEY : Su clave API
     • TRADING_SIM_API_URL : URL del servidor API (opcional)
     • DEBUG : true (opcional, para registro adicional)
5. Haga clic en "Guardar"

Uso de variables de entorno en la configuración del cursor

Para mayor seguridad, puede configurar Cursor a través del archivo .cursor/mcp.json en su directorio de inicio:

Este enfoque elimina la necesidad de un archivo .env.

Añadiendo a Claude Desktop

Para agregar este servidor MCP a Claude Desktop:

1. Primero construya el proyecto con npm run build
2. Localice el archivo de configuración de Claude Desktop en:
   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • En Windows: %APPDATA%\Claude\claude_desktop_config.json
   • En Linux: ~/.config/Claude/claude_desktop_config.json
3. Cree o edite el archivo claude_desktop_config.json con el siguiente contenido:
   { "mcpServers": { "trading-simulator-mcp": { "name": "Trading Simulator MCP", "type": "command", "command": "node", "args": [ "/path/to/trading-simulator-mcp/dist/index.js" ], "env": { "TRADING_SIM_API_KEY": "your_api_key_here", "TRADING_SIM_API_URL": "http://localhost:3000", "DEBUG": "true" } } } }
4. Reemplace /path/to/trading-simulator-mcp/dist/index.js con la ruta completa a su archivo de servidor compilado
   • Ejemplo: /Users/username/trading-simulator-mcp/dist/index.js
5. Guarde el archivo de configuración y reinicie Claude Desktop

Si tiene problemas con Claude Desktop, consulte los registros en:

• En macOS: ~/Library/Logs/Claude/
• En Windows: %USERPROFILE%\AppData\Local\Claude\Logs\
• En Linux: ~/.local/share/Claude/logs/

Nota importante de desarrollo

Al desarrollar el servidor MCP, use console.error() en lugar de console.log() para la depuración y el registro. La aplicación Claude Desktop y Cursor se comunican con el servidor mediante la salida estándar (stdout), por lo que cualquier instrucción console.log() interferirá con esta comunicación y provocará errores de análisis de JSON.

Herramientas MCP

El servidor proporciona las siguientes herramientas MCP:

Herramientas de cuenta

• get_balances - Obtén los saldos de tokens para tu equipo
• get_portfolio - Obtenga información de la cartera de su equipo
• get_trades - Obtén el historial de transacciones de tu equipo

Herramientas de precios

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

Herramientas de trading

• execute_trade - Ejecutar un intercambio entre dos tokens
  • Detecta y asigna automáticamente parámetros de cadena para tokens comunes
  • Admite el comercio en la misma cadena sin requerir parámetros de cadena explícitos
  • Retrocede con gracia en escenarios de cadena cruzada
• get_quote - Obtenga una cotización para una posible operación

Herramientas de competición

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

Fichas comunes

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

Los tokens comunes actuales incluyen:

Solana (SVM)

• Dólar estadounidense: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• SOL: So11111111111111111111111111111111111111112

Ethereum (EVM)

• Dólar estadounidense: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Base (EVM)

• Dólar estadounidense: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• ETH: 0x4200000000000000000000000000000000000006

Para agregar más tokens comunes, puede ampliar el objeto COMMON_TOKENS en el archivo types.ts .

Consideraciones de seguridad

• Su clave API debe mantenerse segura y nunca compartirse ni exponerse en el código del lado del cliente.
• Utilice siempre HTTPS al conectarse a la API en entornos de producción
• La clave API tiene acceso completo para ejecutar operaciones, así que protéjala como corresponde