Servidor MCP

Ejecuta QTSurfer desde un asistente de IA — instala el servidor Model Context Protocol, conéctalo a Claude Code o Codex con una clave de API, y usa sus herramientas para datos de mercado, conjuntos de datos, estrategias, backtests, barridos y ejecuciones en vivo.

El servidor MCP de QTSurfer expone el backtesting y los datos de mercado como herramientas sobre el Model Context Protocol, de modo que un asistente compatible con MCP puede listar exchanges, enviar una estrategia, ejecutar un barrido y leer los resultados sin salir de la conversación. Se publica como QTSurfer/mcp-java bajo Apache-2.0, habla JSON-RPC 2.0 sobre la entrada y salida estándar, y está respaldado por el SDK de Java, que gestiona la autenticación y la orquestación de compilar, preparar y ejecutar, con reintentos y cancelación.

Instalación

En Linux y macOS, el instalador detecta la plataforma y elige un binario nativo (Linux x86_64, Apple Silicon) o un fat JAR con un script envoltorio (otras arquitecturas, Java 21 o posterior):

curl -fsSL https://raw.githubusercontent.com/QTSurfer/mcp-java/main/install.sh | bash

En Windows:

irm https://raw.githubusercontent.com/QTSurfer/mcp-java/main/install.ps1 | iex

El fat JAR se ejecuta en cualquier sitio con JDK 21 o posterior, y se publica una imagen Docker como ghcr.io/qtsurfer/mcp-java. Cada release en GitHub lleva las tres entregas; fija una versión con la variable VERSION cuando la reproducibilidad importe.

Autenticación

Genera una clave de API de larga duración en la aplicación web de QTSurfer y pásala al servidor mediante la variable de entorno QTSURFER_APIKEY o la opción --apikey. Al arrancar, el servidor intercambia la clave por un token de corta duración y lo renueva durante toda la vida del proceso. Si la clave falta o se rechaza, el servidor termina con un error claro antes de exponer ninguna herramienta, así que el fallo aparece en la lista de servidores del asistente en lugar de como un error de herramienta confuso más adelante.

Crea la clave con los alcances que necesite tu trabajo. La API rechaza una operación cuyo alcance no lleva la clave (403, insufficient_scope), y una clave sin alcances se rechaza al canjearla por un token. Autenticación y alcances lista el alcance que exige cada operación.

Conectar un asistente

Claude Code lee ~/.claude.json:

{
  "mcpServers": {
    "qtsurfer": {
      "type": "stdio",
      "command": "/path/to/qtsurfer-mcp",
      "env": { "QTSURFER_APIKEY": "<your-api-key>" }
    }
  }
}

OpenAI Codex lee ~/.codex/config.toml:

[mcp_servers.qtsurfer]
command = "/path/to/qtsurfer-mcp"

[mcp_servers.qtsurfer.env]
QTSURFER_APIKEY = "<your-api-key>"

Para el fat JAR, el comando es java con -jar /path/to/qtsurfer-mcp-java.jar como argumentos; para Docker, docker run -i --rm -e QTSURFER_APIKEY ghcr.io/qtsurfer/mcp-java:latest. Cualquier otro cliente MCP que admita servidores stdio se configura de la misma forma.

Herramientas

ÁreaHerramientasQué hacen
Cuentaget_account, get_account_usageLeer los límites del plan, los permisos de la clave de API y el uso actual de almacenamiento.
Datos de mercadolist_exchanges, list_instruments, list_pools, download_tickers, download_klinesDescubrir exchanges y sus segmentos, instrumentos con sus ventanas de cobertura y pools DEX; transmitir un segmento de una hora UTC a un fichero local.
Conjuntos de datosupload_dataset, import_dataset, get_dataset_import, list_datasets, get_dataset, get_dataset_upload, finalize_dataset_upload, delete_datasetCrear o versionar un conjunto de datos a partir de un fichero CSV o Parquet local, o importar en uno el histórico de un exchange o de un pool; sondear su ingesta o su importación y gestionarlo.
Estrategiascompile_strategy, list_strategies, get_strategy_code, delete_strategyRegistrar el código fuente y leer las propiedades que declara y las capacidades del plan que requiere; inspeccionar y liberar las estrategias registradas en la cuenta.
Backtestssubmit_backtest, get_job_status, get_equity_curve, list_jobsCompilar código fuente Java y ejecutarlo contra un instrumento o un conjunto de datos listo; leer métricas y una curva de equity submuestreada.
Barridossubmit_sweep, get_sweep_status, get_sweep_sensitivity, get_sweep_run_equity_curve, cancel_sweepEjecutar una cuadrícula de parámetros, opcionalmente validada con walk-forward; leer la clasificación ordenada por meseta, las marginales de sensibilidad y las curvas retenidas.
En vivostart_live, get_live, get_live_run, list_live, list_public_live, update_live, update_live_params, send_live_command, get_live_signals, rotate_live_stream, revoke_live_stream, stop_liveArrancar la ejecución en vivo de una estrategia, seguir su estado, cambiar sus metadatos y parámetros, enviarle un comando, leer sus señales retenidas, gestionar su flujo de señales y detenerla.

submit_backtest recibe el código fuente Java completo de la clase de estrategia como strategyCode; la compilación ocurre en la plataforma. Para una ejecución sobre un conjunto de datos, pasa datasetId y omite el exchange y el instrumento. submit_sweep bloquea hasta que la plataforma ha compilado la estrategia, preparado la sesión y aceptado el barrido, lo que en una ventana larga tarda lo mismo que tarde la preparación.

Un barrido a través de MCP es el mismo objeto que un barrido a través de la API, lo cual importa porque no es un bucle de backtests: la clasificación se ordena por meseta, cada fila lleva un ratio de Sharpe deflactado, el barrido informa de una probabilidad de sobreajuste del backtest, los pliegues walk-forward se puntúan fuera de muestra, y las marginales de sensibilidad dicen si un eje movió el objetivo en absoluto. Consulta Barridos de parámetros para la semántica.

compile_strategy registra el código fuente e informa de las propiedades que declara y de las capacidades del plan que requiere, como indicators.pro. Registrar se acepta en cualquier plan; ejecutar una estrategia cuyos requisitos el plan no incluye se rechaza con 402, que lleva una dirección para mejorar el plan cuando la plataforma tiene una y no puede salir bien al reintentar hasta que el plan cambie (los indicadores pro y tu plan).

import_dataset trae a un conjunto de datos el histórico de un exchange o de un pool, y get_dataset_import lo sondea. La importación informa de la cadencia en efecto, que es la de por defecto del plan cuando no se pide ninguna (Cadencias por plan).

Las herramientas en vivo manejan las mismas ejecuciones que la API en vivo. La primera ejecución de una estrategia arranca en una prueba de sandbox antes de pasar a vivo, y sandboxMinutes pide una más larga; stream=true pide una dirección secreta de WebSocket plano para las señales, que hay que tratar como una contraseña.

Ficheros locales: subidas y descargas

Subir un conjunto de datos y descargar datos de mercado tocan el sistema de ficheros local, así que cada una está desactivada hasta que se le da un directorio raíz: --upload-root (o QTSURFER_UPLOAD_ROOT) para ficheros de conjunto de datos legibles, y --download-root (o QTSURFER_DOWNLOAD_ROOT) para la salida de segmentos escribible. Las rutas se canonicalizan y deben permanecer bajo su raíz; los escapes por symlink o por recorrido de directorios se rechazan; las descargas se escriben a través de un fichero temporal y nunca sobrescriben uno existente salvo que se pida. La herramienta de subida solo devuelve identificadores de conjunto de datos e ingesta, nunca la URL de almacenamiento de corta duración.

Con Docker, monta el directorio de subida como solo lectura y un directorio de descarga separado como escribible:

docker run -i --rm -e QTSURFER_APIKEY 
  -e QTSURFER_UPLOAD_ROOT=/uploads -e QTSURFER_DOWNLOAD_ROOT=/downloads 
  -v "$PWD/datasets:/uploads:ro" -v "$PWD/exports:/downloads" 
  ghcr.io/qtsurfer/mcp-java:latest

Una sesión típica

> list_exchanges
> list_instruments exchangeId=binance
> submit_backtest exchangeId=binance instrument=BTC/USDT from=2026-05-10 to=2026-05-16 strategyCode=<Java source>
> get_job_status jobId=<id>
> submit_sweep exchangeId=binance instrument=BTC/USDT from=2026-01-01 to=2026-03-31 params={"rsiPeriod":{"from":7,"to":28,"step":1}}
> get_sweep_status sweepId=<id>
> get_sweep_sensitivity sweepId=<id>

El asistente rellena el fuente de la estrategia, normalmente generado con la skill de estrategia, y lee los resultados de vuelta como texto. Las métricas siguen la referencia de métricas; el servidor representa los ratios como porcentajes en sus resúmenes para que se lean mejor.

Opciones

--url    <base-url>    API base URL (default: https://api.qtsurfer.net/v1)
--apikey <key>         Long-lived API key (default: QTSURFER_APIKEY)
--upload-root <dir>    Permit dataset upload files only beneath this directory
--download-root <dir>  Permit market-data output only beneath this directory
--stub                 In-memory stub, no backend required

El modo stub ejecuta la superficie de herramientas contra datos en memoria, lo cual basta para comprobar la configuración de un asistente antes de gastar una clave de API.

Páginas relacionadas