Servidor comercial MCP

Un servidor de Protocolo de Contexto Modelo (MCP) para operadores de bolsa.

Características

Herramientas

El servidor proporciona las siguientes herramientas para el análisis y el comercio de acciones:

• analizar-stock : Realiza un análisis técnico sobre un símbolo bursátil determinado
  • Argumento requerido: symbol (cadena, p. ej., "NVDA")
  • Devuelve un análisis técnico completo que incluye:
    • Tendencias de medias móviles (SMA de 20, 50 y 200)
    • Indicadores de momentum (RSI, MACD)
    • Métricas de volatilidad (ATR, ADRP)
    • Análisis de volumen
• fuerza relativa : calcula la fuerza relativa de una acción en comparación con un índice de referencia
  • Argumento requerido: symbol (cadena, p. ej., "AAPL")
  • Argumento opcional: benchmark (cadena, valor predeterminado: "SPY")
  • Devuelve métricas de fuerza relativa en múltiples períodos de tiempo (21, 63, 126, 252 días)
  • Incluye comparación de rendimiento entre las acciones y el índice de referencia.
• volume-profile : analiza la distribución del volumen por precio
  • Argumento requerido: symbol (cadena, p. ej., "MSFT")
  • Argumento opcional: lookback_days (entero, predeterminado: 60)
  • Devuelve el análisis del perfil de volumen que incluye:
    • Punto de control (POC): nivel de precio con mayor volumen
    • Área de valor (70% del rango de volumen)
    • Niveles de precios de volumen máximos
• detect-patterns : identifica patrones gráficos en datos de precios
  • Argumento requerido: symbol (cadena, p. ej., "AMZN")
  • Devuelve patrones gráficos detectados con niveles de confianza y objetivos de precios.
• position-size : Calcula el tamaño de posición óptimo en función de los parámetros de riesgo
  • Argumentos obligatorios:
    • symbol (cadena, p. ej., "TSLA")
    • stop_price (número)
    • risk_amount (número)
    • account_size (número)
  • Argumento opcional: price (número, predeterminado: precio actual)
  • Devuelve el tamaño de posición recomendado, el riesgo en dólares y los objetivos de ganancias potenciales
• suggests-stops : sugiere niveles de stop loss basados en análisis técnico
  • Argumento requerido: symbol (cadena, p. ej., "META")
  • Devuelve múltiples sugerencias de stop loss basadas en:
    • Paradas basadas en ATR (1x, 2x, 3x ATR)
    • Paradas basadas en porcentajes (2%, 5%, 8%)
    • Niveles técnicos (promedios móviles, mínimos recientes)

Capacidades de análisis técnico

El servidor aprovecha varios módulos de análisis especializados:

• Análisis técnico : Indicadores técnicos básicos y análisis de tendencias
  • Medias móviles (SMA 20, 50, 200)
  • Indicadores de momentum (RSI, MACD)
  • Métricas de volatilidad (ATR, porcentaje de rango diario promedio)
  • Análisis de volumen (volumen promedio de 20 días)
• RelativeStrength : Análisis comparativo del rendimiento
  • Puntuación de fuerza relativa en múltiples marcos temporales (21, 63, 126, 252 días)
  • Comparación del rendimiento con índices de referencia
  • Clasificación de rendimiento superior/inferior
• VolumeProfile : Análisis de volumen avanzado
  • Distribución del volumen a nivel de precios
  • Identificación del punto de control (POC)
  • Cálculo del área de valor (70% del volumen)
• PatternRecognition : Detección de patrones de gráficos
  • Niveles de soporte/resistencia
  • Patrones gráficos comunes (cabeza y hombros, doble techo/suelo, etc.)
  • Puntuación de confianza para patrones detectados
• Análisis de riesgos : dimensionamiento de posiciones y gestión de riesgos
  • Dimensionamiento de la posición basado en el riesgo
  • Múltiples estrategias de stop loss
  • Cálculo del objetivo de beneficio múltiplo R

Fuentes de datos

El servidor utiliza la API de Tiingo para los datos del mercado:

• Datos históricos diarios de OHLCV
• Precios ajustados para realizar pruebas retrospectivas precisas
• Hasta 1 año de datos históricos por defecto

Configuración

Prerrequisitos

• Python 3.11+
• ultravioleta
• ta-lib
• Clave API de Tiingo

Variables de entorno

Crea un archivo .env :

Instalación mediante herrería

Para instalar Trader for Claude Desktop automáticamente a través de Smithery :

Esto hará lo siguiente:

1. Instalar el servidor MCP Trader
2. Configúralo con tu clave API de Tiingo
3. Configurar la integración de Claude Desktop

Configuración de herrería

El servidor incluye un archivo de configuración smithery.yaml que define:

• Parámetros de configuración necesarios (clave API de Tiingo)
• Función de comando para iniciar el servidor MCP
• Integración con Claude Desktop

Puede personalizar la configuración de Smithery editando el archivo smithery.yaml .

Instalación

Implementación de Docker

El proyecto incluye un Dockerfile para implementación en contenedores:

Para ejecutar el contenedor en modo de servidor HTTP:

Configuración

Aplicación de escritorio Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración de desarrollo:

Desarrollo

Construir y ejecutar

Modo de servidor HTTP

El servidor también puede ejecutarse como un servidor HTTP independiente para realizar pruebas o integrarse con otras aplicaciones:

Esto inicia un servidor HTTP en http://localhost:8000 con los siguientes puntos finales:

• GET /list-tools : Devuelve una lista de herramientas disponibles y sus esquemas
• POST /call-tool : ejecuta una herramienta con los argumentos proporcionados
  • Formato del cuerpo de la solicitud:
    { "name": "analyze-stock", "arguments": { "symbol": "AAPL" } }
  • Devuelve una matriz de elementos de contenido (texto, imágenes, etc.)

Depuración

Utilice el Inspector MCP para depurar:

Ejemplo de uso

En Claude Desktop:

El servidor devolverá un resumen del análisis técnico que incluye el estado de la tendencia, indicadores de impulso y métricas clave.

Dependencias

Consulte pyproject.toml para obtener la lista completa de dependencias:

Contribuyendo

¡Agradecemos tus contribuciones a MCP Trader! Aquí tienes algunas maneras de contribuir:

• Agregar nuevas herramientas : Implementar herramientas de análisis técnico adicionales o estrategias comerciales
• Mejorar las herramientas existentes : mejorar la precisión o el rendimiento de las herramientas actuales
• Añadir fuentes de datos : integrar proveedores de datos de mercado adicionales
• Documentación : Mejorar la documentación o añadir ejemplos.
• Corrección de errores : solucione problemas o mejore el manejo de errores

Flujo de trabajo de desarrollo

1. Bifurcar el repositorio
2. Crear una rama de características ( git checkout -b feature/amazing-feature )
3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
4. Empujar a la rama ( git push origin feature/amazing-feature )
5. Abrir una solicitud de extracción

Planes futuros

El proyecto MCP Trader tiene varias mejoras planificadas:

• Análisis de cartera : Herramientas para analizar y optimizar carteras
• Backtesting : Capacidades para probar estrategias comerciales en datos históricos
• Análisis de sentimientos : integración con datos de sentimiento de noticias y redes sociales
• Análisis de opciones : herramientas para analizar estrategias y precios de opciones
• Datos en tiempo real : Soporte para feeds de datos de mercado en tiempo real
• Estrategias personalizadas : Marco para implementar y probar estrategias comerciales personalizadas
• Alertas : Sistema de notificación de alertas de precios e indicadores técnicos

Lectura adicional

Obtenga más información sobre este proyecto a través de estas publicaciones de blog detalladas:

• Creación de un servidor de análisis de acciones con MCP, parte 1 : configuración inicial, arquitectura y funciones principales de análisis técnico
• Creación de un servidor de análisis de acciones con MCP, parte 2 : Fuerza relativa, volumen, reconocimiento de patrones y análisis de riesgos