Financial Data MCP Server

Servidor MCP de Dados Financeiros

Um servidor Model Context Protocol (MCP) que fornece a assistentes de IA dados de mercado financeiro em tempo real por meio do Yahoo Finance.

Recursos

• Dados de Ações: Preços atuais, dados históricos, métricas de mercado
• Opções: Cadeias de opções com preços de exercício, preços e volume
• Análise Técnica: Médias móveis, RSI, índice de Sharpe
• Comparações: Compare múltiplas ações em várias métricas
• Notícias: Obtenha manchetes recentes de notícias da empresa
• Dividendos: Obtenha o histórico de dividendos de uma ação

Instalação

pip install "mcp[cli]" yfinance pandas numpy

Configuração

Adicione à configuração do Claude Desktop:

{
  "mcpServers": {
    "financial-data": {
      "command": "python",
      "args": ["path/to/server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Ferramentas Disponíveis

Aqui está uma lista detalhada das ferramentas disponíveis por meio deste servidor.

Dados de Ações

• get_stock_price(symbol: str)

  Obtenha o preço atual da ação e informações básicas.

• get_historical_data(symbol: str, period: str = "1mo", interval: str = "1d")

  Obtenha dados históricos de preços de uma ação.

• get_options_chain(symbol: str, expiration_date: Optional[str] = None, sort_by: Optional[str] = "volume", limit: int = 20, descending: bool = True)

  Obtenha dados da cadeia de opções de uma ação.

• get_company_news(symbol: str, limit: int = 5)

  Obtenha manchetes recentes de notícias da empresa.

• get_dividends(symbol: str, period: str = "5y")

  Obtenha o histórico de dividendos de uma ação.

Cálculos Financeiros

• calculate_moving_average(symbol: str, period: int = 20, ma_type: str = "SMA")

  Calcule a média móvel de uma ação.

• calculate_rsi(symbol: str, period: int = 14)

  Calcule o Índice de Força Relativa (RSI) de uma ação.

• calculate_sharpe_ratio(symbol: str, period: str = "1y", risk_free_rate: float = 0.05)

  Calcule o Índice de Sharpe de uma ação.

Comparação

• compare_stocks(symbols: List[str], metric: str = "performance")

  Compare múltiplas ações por várias métricas.

Utilitário

• clear_cache()

  Limpe o cache para forçar a recuperação de dados atualizados.

Exemplos de Uso

"What's the current price of AAPL?"
"Show me TSLA's 50-day moving average"
"Compare AAPL, MSFT, and GOOGL performance"
"Get SPY options expiring this Friday"
"What is the latest news for NVDA?"
"Show me the dividend history for KO over the last 10 years."

Solução de Problemas

• Módulos ausentes: Execute pip install yfinance pandas numpy "mcp[cli]"
• Sem dados: Verifique o símbolo do ticker e a conexão com a internet
• Problemas no servidor: Verifique o caminho do Python na configuração, reinicie o Claude Desktop

Observações

• Dados do Yahoo Finance (atraso de 15 a 20 minutos)
• Cache automático e limitação de taxa
• Apenas para fins informativos

Licença

Licença MIT