StockFlow MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona datos bursátiles en tiempo real y análisis de opciones a través de Yahoo Finance. Permite a los LLM acceder a datos de mercado, analizar acciones y evaluar estrategias de opciones.

Características

Datos de acciones

• Precios de acciones en tiempo real y métricas clave

• Datos históricos de precios con valores OHLC

• Fundamentos de la empresa y estados financieros

• Indicadores de mercado y ratios

Análisis de opciones

• Datos completos de la cadena de opciones

• Griegas (delta, gamma, theta, vega)

• Seguimiento de volumen e interés abierto

• Análisis de estrategias de opciones

Related MCP server: MCP Yahoo Finance

Instalación

# Install dependencies
pip install mcp yfinance

# Clone the repository
git clone https://github.com/twolven/stockflow
cd stockflow

Uso

1. Clona el repositorio:

git clone https://github.com/twolven/mcp-stockflow.git
cd mcp-stockflow

2. Instala las dependencias:

pip install -r requirements.txt

3. Añade a tu configuración de Claude: En tu claude-desktop-config.json, añade lo siguiente a la sección mcpServers:

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

Reemplaza "path/to/stockflow.py" con la ruta completa donde guardaste el archivo stockflow.py.

Prompt de uso para Claude

Cuando trabajes con Claude, puedes usar este prompt para ayudarle a entender las herramientas disponibles:

"He habilitado las herramientas de stockflow que te dan acceso a los datos del mercado de valores. Puedes usar estas tres funciones principales:

1. get_stock_data - Obtén información completa de la acción:

{
    "symbol": "AAPL",
    "include_financials": true,  # optional
    "include_analysis": true,    # optional
    "include_calendar": true     # optional
}

2. get_historical_data - Obtén historial de precios e indicadores técnicos:

{
    "symbol": "AAPL",
    "period": "1y",        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
    "interval": "1d",      # 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
    "prepost": false       # optional - include pre/post market data
}

3. get_options_chain - Obtén datos de opciones:

{
    "symbol": "AAPL",
    "expiration_date": "2024-12-20",  # optional - uses nearest date if not specified
    "include_greeks": true            # optional
}

Todas las respuestas incluyen datos de precios actuales, manejo de errores e información completa del mercado."

Ejecutando el servidor

python stockflow.py

Usando con el cliente MCP

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["stockflow.py"]
)

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # Get current stock data
            result = await session.call_tool(
                "get-stock-data", 
                arguments={"symbol": "AAPL"}
            )
            
            # Get options chain
            options = await session.call_tool(
                "get-options-chain",
                arguments={
                    "symbol": "AAPL",
                    "expiration_date": "2024-12-20"
                }
            )

if __name__ == "__main__":
    import asyncio
    asyncio.run(run())

Herramientas disponibles

1. get-stock-data

   • Precio y volumen actuales

   • Capitalización de mercado y ratio P/E

   • Máximo/mínimo de 52 semanas

2. get-historical-data

   • Precios OHLC

   • Períodos de tiempo configurables

   • Datos de volumen

3. get-options-chain

   • Calls y puts

   • Precios de ejercicio

   • Griegas e IV

   • Volumen e interés abierto

Recursos disponibles

1. company-info://{symbol}

   • Descripción de la empresa

   • Sector e industria

   • Número de empleados

   • Sitio web

2. financials://{symbol}

   • Estado de resultados

   • Balance general

   • Estado de flujo de efectivo

Prompts

1. analyze-options

   • Análisis de estrategias de opciones

   • Evaluación de riesgo/recompensa

   • Evaluación de condiciones del mercado

Requisitos

• Python 3.12+

• mcp

• yfinance

Limitaciones

• Los datos provienen de Yahoo Finance y pueden tener retrasos

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

• Se aplican límites de velocidad según las restricciones de la API de Yahoo Finance

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Autor

Todd Wolven - Desarrollador principal de software de IA e ingeniero de GenAI de código abierto

Agradecimientos

• Construido con el Model Context Protocol (MCP) de Anthropic

• Datos proporcionados por Yahoo Finance

• Desarrollado para su uso con Claude de Anthropic