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 -
4
Python
MIT License
Alpaca MCP Server
miguelyad26
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.
Last updated -
Python
MIT License
Ramp MCP Serverofficial
ramp-public
-
security
A
license
-
quality
A Model Context Protocol server that enables access to Ramp financial data through an in-memory database, allowing LLMs to analyze transactions, reimbursements, bills, and other financial information from Ramp's platform.
Last updated -
14
Python
MIT License
MCP Avantage
MissionSquad
A
security
F
license
A
quality
A Model Context Protocol server that enables LLMs to access comprehensive financial data from Alpha Vantage API, including stock prices, fundamentals, forex, crypto, and economic indicators.
Last updated -
94
12
JavaScript

View all related MCP servers

StockFlow MCP Server