YFinance Trader

Ferramenta MCP YFinance Trader para Claude Desktop

Uma ferramenta MCP (Model Context Protocol) que fornece dados do mercado de ações e capacidades de negociação usando a biblioteca yfinance, especificamente adaptada para Claude Desktop.

Crédito: Este projeto foi inspirado em mcp-stocks por Luigi Ajah, que é uma implementação semelhante para Cursor. Esta adaptação modifica o conceito original para funcionar com Claude Desktop.

Tutorial

Para um guia detalhado sobre configuração e uso desta ferramenta, confira nosso tutorial no Medium: Tutorial: Usando Claude Desktop com a Ferramenta MCP YFinance Trader para Acessar Dados do Mercado de Ações em Tempo Real

Recursos

• Cotações de ações em tempo real
• Informações da empresa e métricas financeiras
• Dados históricos de preços
• Funcionalidade de busca de símbolos
• Recomendações de analistas
• Rastreamento de transações de insiders

Configuração

1. Certifique-se de ter Python 3.10 ou superior instalado

2. Instale as dependências:

pip install -r requirements.txt

Integração com Claude Desktop

1. Configure suas configurações de MCP no Claude Desktop adicionando o seguinte à sua configuração de MCP:

{
  "mcpServers": {
    "yfinance-trader": {
      "command": "py",
      "args": ["-3.13", "path/to/your/main.py"]
    }
  }
}

2. Substitua o caminho pelo caminho completo para o seu arquivo main.py
3. Reinicie o Claude Desktop se necessário

Ferramentas Disponíveis

1. get_stock_quote

Obtenha informações de cotação de ações em tempo real:

{
    "symbol": "AAPL",
    "price": 150.25,
    "change": 2.5,
    "changePercent": 1.67,
    "volume": 1234567,
    "timestamp": "2024-03-20T10:30:00"
}

2. get_company_overview

Obtenha informações da empresa e métricas principais:

{
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. get_time_series_daily

Obtenha dados históricos de preços diários:

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 151.75,
            "volume": 12345678
        }
        // ... more data points
    ]
}

4. search_symbol

Pesquise ações e outros títulos:

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... more results
    ]
}

5. get_recommendations

Obtenha recomendações de analistas para uma ação:

{
    "symbol": "AAPL",
    "recommendations": [
        {
            "period": "2024-03-15T00:00:00",
            "strongBuy": 15,
            "buy": 20,
            "hold": 8,
            "sell": 2,
            "strongSell": 0
        }
        // ... more periods
    ]
}

6. get_insider_transactions

Obtenha informações sobre transações de insiders:

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "John Doe",
            "position": "Director",
            "transactionType": "Buy",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "Purchase of 1000 shares",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... more transactions
    ]
}

Exemplos de Consultas

Você pode fazer perguntas ao Claude Desktop como:

• "Qual é o preço atual da ação e a variação diária da AAPL?"
• "Você pode me dar uma visão geral da empresa Microsoft (MSFT)?"
• "Mostre-me os dados históricos de preços da Tesla (TSLA) nos últimos 3 meses."
• "Pesquise ações relacionadas a 'NVDA'."
• "Quais são as recomendações dos analistas para a Amazon (AMZN)?"
• "Houve alguma transação recente de insiders para o Google (GOOGL)?"

Suporte a Criptomoedas

Dados limitados de criptomoedas estão disponíveis usando formatos especiais de ticker:

• BTC-USD para Bitcoin
• ETH-USD para Ethereum
• DOGE-USD para Dogecoin

Tratamento de Erros

Todas as ferramentas incluem tratamento adequado de erros e retornarão uma mensagem de erro se algo der errado:

{
    "error": "Failed to fetch quote for INVALID_SYMBOL"
}

Solução de Problemas

Se o servidor MCP não estiver funcionando no Claude Desktop:

1. Certifique-se de que o servidor está em execução - você deve ver a saída ao iniciar o script
2. Verifique se o caminho nas suas configurações está correto e é absoluto
3. Certifique-se de que Python 3.10+ esteja no PATH do seu sistema
4. Verifique se todas as dependências estão instaladas
5. Tente reiniciar o Claude Desktop
6. Verifique os logs para ver se há mensagens de erro

Diferenças do projeto original mcp-stocks

• Usa a biblioteca MCP diretamente em vez de FastAPI
• Adaptado para Claude Desktop em vez de Cursor
• Tratamento de erros e formatos de resposta modificados
• Abordagem de configuração atualizada

Licença

Licença MIT