StockFlow

Servidor MCP StockFlow

Um servidor Model Context Protocol (MCP) que fornece dados de ações em tempo real e análise de opções por meio do Yahoo Finance. Permite que LLMs acessem dados de mercado, analisem ações e avaliem estratégias de opções.

Recursos

Dados de Ações

• Preços de ações em tempo real e métricas-chave
• Dados históricos de preços com valores OHLC
• Fundamentos da empresa e demonstrações financeiras
• Indicadores de mercado e índices

Análise de Opções

• Dados completos da cadeia de opções
• Gregos (delta, gamma, theta, vega)
• Acompanhamento de volume e interesse em aberto
• Análise de estratégias de opções

Instalação

# Install dependencies
pip install mcp yfinance

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

Uso

1. Clone o repositório:

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

2. Instale as dependências:

pip install -r requirements.txt

3. Adicione à sua configuração do Claude: No seu claude-desktop-config.json, adicione o seguinte à seção mcpServers:

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

Substitua "path/to/stockflow.py" pelo caminho completo onde você salvou o arquivo stockflow.py.

Prompt de Uso para o Claude

Ao trabalhar com o Claude, você pode usar este prompt para ajudá-lo a entender as ferramentas disponíveis:

"Ativei as ferramentas stockflow que dão acesso a dados do mercado de ações. Você pode usar estas três funções principais:

1. get_stock_data - Obter informações abrangentes sobre ações:

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

2. get_historical_data - Obter histórico de preços 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 - Obter dados de opções:

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

Todas as respostas incluem dados de preço atuais, tratamento de erros e informações abrangentes de mercado."

Executando o Servidor

python stockflow.py

Usando com o 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())

Ferramentas Disponíveis

1. get-stock-data

   • Preço atual e volume
   • Capitalização de mercado e índice P/L
   • Máxima/mínima de 52 semanas

2. get-historical-data

   • Preços OHLC
   • Períodos de tempo configuráveis
   • Dados de volume

3. get-options-chain

   • Calls e puts
   • Preços de exercício
   • Gregos e IV
   • Volume e interesse em aberto

Recursos Disponíveis

1. company-info://{symbol}

   • Descrição da empresa
   • Setor e indústria
   • Número de funcionários
   • Site

2. financials://{symbol}

   • Demonstração de resultados
   • Balanço patrimonial
   • Demonstração do fluxo de caixa

Prompts

1. analyze-options
   • Análise de estratégias de opções
   • Avaliação de risco/retorno
   • Avaliação das condições de mercado

Requisitos

• Python 3.12+
• mcp
• yfinance

Limitações

• Os dados são provenientes do Yahoo Finance e podem apresentar atrasos
• A disponibilidade dos dados de opções depende do horário de funcionamento do mercado
• Limites de taxa se aplicam com base nas restrições da API do Yahoo Finance

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Autor

Todd Wolven - Desenvolvedor Líder de IA e engenheiro de GenAI de código aberto

Agradecimentos

• Construído com o Model Context Protocol (MCP) da Anthropic
• Dados fornecidos pelo Yahoo Finance
• Desenvolvido para uso com o Claude da Anthropic