Skip to main content
Glama
enesjakozh

StockScreen MCP Server

by twolven
GitHub
Python
MIT License
32
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor MCP de StockScreen

Un servidor de Protocolo de Contexto de Modelo (MCP) que ofrece funciones integrales de selección de acciones a través de Yahoo Finance. Permite a los LLM seleccionar acciones según criterios técnicos, fundamentales y de opciones, con soporte para la gestión de listas de seguimiento y el almacenamiento de resultados.

Características

Selección de acciones

  • Evaluación de análisis técnico

    • Filtros de precio y volumen

    • Promedios móviles (SMA de 20, 50 y 200)

    • Indicadores RSI

    • Rango verdadero promedio (ATR)

    • Análisis de tendencias (cambios en 1 día, 5 días y 20 días)

    • Cálculos de distancia MA

  • Detección fundamental

    • Filtros de capitalización de mercado

    • Análisis de la relación precio-beneficio

    • Criterios de rendimiento de dividendos

    • Métricas de crecimiento de los ingresos

    • Métricas específicas de ETF (AUM, ratio de gastos)

  • Evaluación de opciones

    • Filtros de volatilidad implícita (IV)

    • Volumen de opciones e interés abierto

    • Análisis de la relación put/call

    • Evaluación del diferencial entre oferta y demanda

    • Verificaciones de proximidad de la fecha de ganancias

Gestión de datos

  • Creación y gestión de listas de vigilancia

  • Almacenamiento de resultados de detección

  • Categorías de símbolos predeterminadas

    • Mega capitalización (>$200 mil millones)

    • Gran capitalización ($10 mil millones a $200 mil millones)

    • Mediana capitalización ($2 mil millones a $10 mil millones)

    • Pequeña capitalización (300 millones de dólares - 2 mil millones de dólares)

    • Micro capitalización (<$300 millones)

    • ETF

Instalación

# Install dependencies pip install -r requirements.txt # Clone the repository git clone https://github.com/twolven/mcp-stockscreen.git cd mcp-stockscreen

Uso

  1. Agregue a su configuración de Claude: En su claude-desktop-config.json , agregue lo siguiente a la sección mcpServers :

{ "mcpServers": { "stockscreen": { "command": "python", "args": ["path/to/stockscreen.py"] } } }

Reemplace "path/to/stockscreen.py" con la ruta completa donde guardó el archivo stockscreen.py.

Herramientas disponibles

Herramientas disponibles

  1. run_stock_screen

Criterios de selección técnica

{ "screen_type": "technical", "criteria": { "min_price": float, # Minimum stock price "max_price": float, # Maximum stock price "min_volume": int, # Minimum average volume "above_sma_200": bool, # Price above 200-day SMA "above_sma_50": bool, # Price above 50-day SMA "min_rsi": float, # Minimum RSI value "max_rsi": float, # Maximum RSI value "max_atr_pct": float, # Maximum ATR as percentage of price "category": str # Optional: market cap category filter }, "watchlist": str, # Optional: name of watchlist to screen "save_result": str # Optional: name to save results }

Criterios fundamentales de selección

{ "screen_type": "fundamental", "criteria": { "min_market_cap": float, # Minimum market capitalization "min_pe": float, # Minimum P/E ratio "max_pe": float, # Maximum P/E ratio "min_dividend": float, # Minimum dividend yield (%) "min_revenue_growth": float, # Minimum revenue growth rate "category": str, # Optional: market cap category filter # ETF-specific criteria "min_aum": float, # Minimum assets under management "max_expense_ratio": float, # Maximum expense ratio "min_volume": float # Minimum trading volume }, "watchlist": str, # Optional: name of watchlist to screen "save_result": str # Optional: name to save results }

Criterios de la pantalla de opciones

{ "screen_type": "options", "criteria": { "min_iv": float, # Minimum implied volatility (%) "max_iv": float, # Maximum implied volatility (%) "min_option_volume": int, # Minimum options volume "min_put_call_ratio": float, # Minimum put/call ratio "max_spread": float, # Maximum bid-ask spread (%) "min_days_to_earnings": int, # Minimum days until earnings "max_days_to_earnings": int, # Maximum days until earnings "category": str # Optional: market cap category filter }, "watchlist": str, # Optional: name of watchlist to screen "save_result": str # Optional: name to save results }

Criterios de la pantalla de noticias

{ "screen_type": "news", "criteria": { "keywords": List[str], # Keywords to search for in news "exclude_keywords": List[str], # Keywords to exclude from results "min_days": int, # Minimum days back to search "max_days": int, # Maximum days back to search "management_changes": bool, # Filter for management changes "require_all_keywords": bool, # Require all keywords to match "category": str # Optional: market cap category filter }, "watchlist": str, # Optional: name of watchlist to screen "save_result": str # Optional: name to save results }

Criterios de pantalla personalizados

{ "screen_type": "custom", "criteria": { "category": str, # Optional: market cap category filter "technical": { # Any technical criteria from above }, "fundamental": { # Any fundamental criteria from above }, "options": { # Any options criteria from above }, "news": { # Any news criteria from above } }, "watchlist": str, # Optional: name of watchlist to screen "save_result": str # Optional: name to save results }

Valores de categoría

Categorías de capitalización de mercado disponibles para filtrar:

  • "mega_cap": >$200 mil millones

  • "gran capitalización": 10 mil millones de dólares a 200 mil millones de dólares

  • "mid_cap": $2 mil millones - $10 mil millones

  • "small_cap": $300 millones - $2 mil millones

  • "micro_cap": <$300 millones

  • "etf": instrumentos ETF

  1. manage_watchlist

{ "action": str, # Required: "create", "update", "delete", "get" "name": str, # Required: watchlist name (1-50 chars, alphanumeric with _ -) "symbols": List[str] # Required for create/update: list of stock symbols }

  1. get_screening_result

{ "name": str # Required: name of saved screening result }

Formatos de respuesta

Respuesta técnica de la pantalla

{ "screen_type": "technical", "criteria": dict, # Original criteria used "matches": int, # Number of matching stocks "results": [ # List of matching stocks { "symbol": str, "price": float, "volume": float, "rsi": float, "sma_20": float, "sma_50": float, "sma_200": float, "atr": float, "atr_pct": float, "price_changes": { "1d": float, # 1-day price change % "5d": float, # 5-day price change % "20d": float # 20-day price change % }, "ma_distances": { "pct_from_20sma": float, "pct_from_50sma": float, "pct_from_200sma": float } } ], "rejected": [ # List of stocks that didn't match { "symbol": str, "rejection_reasons": List[str] } ], "timestamp": str }

Aviso de uso para Claude

He habilitado las herramientas de selección de stock, que ofrecen funciones de selección de stock. Puedes usar tres funciones principales:

  1. Pantallas de stock con varios tipos de criterios:

    • Técnico: Precio, volumen, RSI, medias móviles, ATR

    • Fundamental: capitalización de mercado, precio/beneficio, dividendos, crecimiento

    • Opciones: IV, volumen, fechas de ganancias

    • Personalizado: combinar varios tipos de criterios

  2. Administrar listas de seguimiento:

    • Crear y actualizar listas de símbolos

    • Eliminar listas de seguimiento existentes

    • Recuperar el contenido de la lista de seguimiento

  3. Acceder a los resultados de detección guardados:

    • Cargar resultados de pantalla anteriores

    • Revisar los símbolos y criterios coincidentes

Todas las funciones incluyen manejo de errores, datos detallados del mercado y respuestas integrales".

Requisitos

  • Python 3.12+

  • Servidor MCP

  • yfinanzas

  • pandas

  • Numpy

  • asincronía

Limitaciones

  • Datos procedentes de Yahoo Finance con posibles retrasos.

  • Límites de tarifas basados en las restricciones de la API de Yahoo Finance

  • La disponibilidad de datos de opciones depende del horario del mercado.

  • Algunas métricas financieras pueden retrasarse o no estar disponibles

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Autor

Todd Wolven - ( https://github.com/twolven )

Expresiones de gratitud

  • Construido con el Protocolo de Contexto de Modelo (MCP) de Anthropic

  • Datos proporcionados por Yahoo Finance

  • Desarrollado para su uso con Claude de Anthropic

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Ofrece funciones integrales de selección de acciones a través de Yahoo Finance. Permite a los LLM seleccionar acciones según criterios técnicos, fundamentales y de opciones, con soporte para la gestión de listas de seguimiento y el almacenamiento de resultados.

  1. Características
    1. Selección de acciones
    2. Gestión de datos
  2. Instalación
    1. Uso
      1. Herramientas disponibles
        1. Herramientas disponibles
          1. Criterios de selección técnica
          2. Criterios fundamentales de selección
          3. Criterios de la pantalla de opciones
          4. Criterios de la pantalla de noticias
          5. Criterios de pantalla personalizados
          6. Valores de categoría
        2. Formatos de respuesta
          1. Respuesta técnica de la pantalla
        3. Aviso de uso para Claude
          1. Requisitos
            1. Limitaciones
              1. Contribuyendo
                1. Licencia
                  1. Autor
                    1. Expresiones de gratitud

                      Related MCP Servers

                      • StockFlow MCP Server

                        twolven
                        -
                        security
                        A
                        license
                        -
                        quality
                        A Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.
                        Last updated -
                        20
                        MIT License

                      • Yahoo Finance MCP for LLaMA 3.2 3B

                        Shak2000
                        -
                        security
                        F
                        license
                        -
                        quality
                        Integrates Yahoo Finance API with LLaMA 3.2 3B, allowing users to retrieve real-time stock prices, company information, historical data, and market news while maintaining the model's original capabilities.
                        Last updated -
                        2

                      • MCP Stock Analysis Server

                        giptilabs
                        -
                        security
                        F
                        license
                        -
                        quality
                        Provides access to real-time and historical Indian stock data via Yahoo Finance API, enabling local LLMs to retrieve stock information through MCP-compatible agents like Claude Desktop and Cursor.
                        Last updated -
                        2

                      • Yahoo Finance MCP Server

                        leo-ye0
                        -
                        security
                        F
                        license
                        -
                        quality
                        A comprehensive financial data analysis server providing Yahoo Finance data for stocks, cryptocurrencies, technical analysis, portfolio management, and economic indicators through a clean interface.
                        Last updated -
                        • Apple

                      View all related MCP servers

                      Appeared in Searches

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/twolven/mcp-stockscreen'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server