Yahoo Finance

MCP Yahoo Finance

Um servidor Model Context Protocol (MCP) para interação com o Yahoo Finance. Este servidor fornece ferramentas para obter preços, informações de empresas e gerar visualizações financeiras.

Este projeto é um fork e extensão de maxscheijen/mcp-yahoo-finance, com capacidades de visualização adicionadas.

Recursos

• Dados Financeiros: Obtenha preços atuais de ações, preços históricos, dividendos, demonstrações de resultados e mais
• Análise Visual: Gere visualizações bonitas para sentimento de mercado, acompanhamento de portfólio e análise técnica
• Integração Fácil: Funciona com Claude Desktop, VS Code, Cursor e outros clientes MCP

Instruções de Configuração

1. Clone o Repositório

Clone este repositório para sua máquina local:

git clone https://github.com/leoncuhk/mcp-yahoo-finance.git
cd mcp-yahoo-finance

2. Instale as Dependências

Instale as dependências necessárias usando pip:

pip install -r requirements.txt

Se o arquivo requirements.txt estiver ausente, você pode instalar as dependências diretamente:

pip install mcp yfinance pandas matplotlib seaborn plotly kaleido numpy pillow base64io

3. Configure o Cliente MCP

Claude Desktop

Adicione isso ao seu claude_desktop_config.json (crie se não existir):

• macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

Você também pode usar docker:

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "IMAGE"]
        }
    }
}

VSCode

Adicione isso ao seu .vscode/mcp.json:

{
    "servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

Cursor

Adicione isso à sua configuração MCP do Cursor:

{
    "mcp-servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

4. Reinicie seu cliente MCP

Após configurar, reinicie o Claude Desktop ou seu cliente MCP preferido para carregar o servidor.

Ferramentas Disponíveis

Dados Financeiros Básicos

• get_current_stock_price: Obtenha o preço atual da ação para um símbolo
• get_stock_price_by_date: Obtenha o preço da ação para uma data específica
• get_stock_price_date_range: Obtenha preços de ações para um intervalo de datas
• get_historical_stock_prices: Obtenha dados históricos de ações com períodos personalizáveis
• get_dividends: Obtenha informações de dividendos para uma ação
• get_income_statement: Obtenha dados de demonstração de resultados
• get_cashflow: Obtenha dados de demonstração de fluxo de caixa
• get_earning_dates: Obtenha informações de datas de lucros
• get_news: Obtenha notícias recentes para uma ação

Ferramentas de Visualização

• generate_market_dashboard: Crie um painel de sentimento de mercado com desempenho de índices em tempo real
• generate_portfolio_report: Gere um relatório de acompanhamento de desempenho de portfólio
• generate_stock_technical_analysis: Crie um relatório de análise técnica para uma ação

Exemplos de Visualização

Painel de Sentimento de Mercado

Acompanhamento de Portfólio

Análise Técnica de Ações

Exemplos de Prompts

Aqui estão alguns exemplos de prompts para experimentar com o Claude:

Dados Financeiros Básicos

1. "Qual é o preço atual da ação da Apple?"
2. "Qual é a diferença no preço das ações entre Apple e Google?"
3. "Quanto o preço da ação da Apple mudou entre 2025-01-01 e 2025-3-31?"

Solicitações de Visualização

1. "Gere um painel de sentimento de mercado mostrando o desempenho dos principais índices."
2. "Crie um relatório de acompanhamento de portfólio para ações de tecnologia AAPL, MSFT, GOOGL, AMZN e NVDA."
3. "Mostre-me um gráfico de análise técnica para a ação da Tesla com médias móveis e níveis de suporte/resistência."
4. "Gere um painel de sentimento de mercado com S&P 500, Dow Jones e NASDAQ."
5. "Você pode criar um relatório de portfólio para minhas ações de energia: XOM, CVX, BP, COP e SLB?"
6. "Preciso de uma análise técnica detalhada para a ação da NVDA mostrando padrões de RSI e volume."

Testes

Para testar as capacidades de visualização:

cd tests
python test_visualization.py

Isso gerará imagens de exemplo de visualização no diretório examples.

Licença

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

Agradecimentos

• Projeto original por Max Scheijen
• Estendido com capacidades de visualização inspiradas por tooyipjee