Servidor MCP de StockFlow

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos bursátiles y análisis de opciones en tiempo real 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 y ratios del mercado

Análisis de opciones

Datos completos de la cadena de opciones
Griegos (delta, gamma, theta, vega)
Seguimiento del volumen y el interés abierto
Análisis de la estrategia de opciones

Instalación

# Install dependencies
pip install mcp yfinance

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

Uso

Clonar el repositorio:

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

Instalar dependencias:

pip install -r requirements.txt

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

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

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

Aviso de uso para Claude

Al trabajar con Claude, puedes usar este mensaje para ayudarlo a comprender 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:

get_stock_data - Obtenga información completa sobre las acciones:

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

get_historical_data - Obtener el historial de precios y los 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
}

get_options_chain - Obtener 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.

Ejecución del servidor

python stockflow.py

Uso 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

get-stock-data
- Precio y volumen actuales
- Capitalización de mercado y ratio precio-beneficio
- Máximo/mínimo de 52 semanas
get-historical-data
- Precios de OHLC
- Períodos de tiempo configurables
- Datos de volumen
get-options-chain
- llamadas y opciones de venta
- Precios de ejercicio
- Griegos y IV
- Volumen e interés abierto

Recursos disponibles

company-info://{symbol}
- Descripción de la empresa
- Sector e industria
- Recuento de empleados
- Sitio web
financials://{symbol}
- Estado de resultados
- Balance
- Estado de flujo de efectivo

Indicaciones

analyze-options
- Análisis de la estrategia de opciones
- Evaluación de riesgo/recompensa
- Evaluación de las condiciones del mercado

Requisitos

Python 3.12+
mcp
yfinanzas

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 tarifas según las restricciones de la API de Yahoo Finance.

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

StockFlow MCP Server

Integrations

Servidor MCP de StockFlow

Características

Datos de acciones

Análisis de opciones

Instalación

Uso

Aviso de uso para Claude

Ejecución del servidor

Uso con el cliente MCP

Herramientas disponibles

Recursos disponibles

Indicaciones

Requisitos

Limitaciones

Contribuyendo

Licencia

Autor

Expresiones de gratitud

Expresiones de gratitud

Related Resources

Appeared in Searches