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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de Protocolo de Contexto de Modelo que proporciona datos de acciones y análisis de opciones en tiempo real a través de Yahoo Finance, lo que permite a los LLM acceder a datos de mercado, analizar acciones y evaluar estrategias de opciones.

Related Resources

Reddit Discussion about this server

Related MCP Servers

OptionsFlow MCP Server
twolven
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to analyze options chains, calculate Greeks, and evaluate basic options strategies through Yahoo Finance data.
Last updated -
12
Python
MIT License
MCP Yahoo Finance
maxscheijen
A
security
A
license
A
quality
A Model Context Protocol server that enables interaction with Yahoo Finance to retrieve stock pricing, company information, and historical financial data through natural language queries.
Last updated -
9
12
Python
MIT License
MCP Yahoo Finance
marckwei
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Yahoo Finance, allowing users to retrieve stock prices, company information, and perform financial data comparisons.
Last updated -
11
Python
MIT License
Finance MCP Server
dino65-dev
-
security
A
license
-
quality
Provides real-time financial data from Yahoo Finance to Large Language Models through the Model Context Protocol, enabling AI models to access stock prices, historical data, and company information.
Last updated -
Python
MIT License

View all related MCP servers

StockFlow MCP Server