Financial Datasets

oficial

API do mercado de ações feita para agentes de IA

GitHub
2.2k

O que você pode fazer com Financial Datasets MCP?

  • Fetch income statements — Retrieve a company's income statements using get_income_statements.
  • Fetch balance sheets — Retrieve a company's balance sheets using get_balance_sheets.
  • Fetch cash flow statements — Retrieve a company's cash flow statements using get_cash_flow_statements.
  • Get current stock or crypto prices — Look up the latest price for a ticker via get_current_stock_price or get_current_crypto_price.
  • Get historical stock or crypto prices — Pull historical price data for a date range using get_historical_stock_prices or get_historical_crypto_prices.
  • Get company news — Retrieve recent news articles for a company with get_company_news.

Documentação

Financial Datasets MCP Server

Introdução

Este é um servidor Model Context Protocol (MCP) que fornece acesso a dados do mercado de ações do Financial Datasets.

Ele permite que o Claude e outros assistentes de IA recuperem demonstrações de resultados, balanços patrimoniais, demonstrações de fluxo de caixa, preços de ações e notícias de mercado diretamente através da interface MCP.

Ferramentas Disponíveis

Este servidor MCP oferece as seguintes ferramentas:

  • get_income_statements: Obtém demonstrações de resultados de uma empresa.
  • get_balance_sheets: Obtém balanços patrimoniais de uma empresa.
  • get_cash_flow_statements: Obtém demonstrações de fluxo de caixa de uma empresa.
  • get_current_stock_price: Obtém o preço atual / mais recente de uma empresa.
  • get_historical_stock_prices: Obtém preços históricos de ações de uma empresa.
  • get_company_news: Obtém notícias de uma empresa.
  • get_available_crypto_tickers: Obtém todos os tickers de criptomoedas disponíveis.
  • get_crypto_prices: Obtém preços históricos de uma criptomoeda.
  • get_historical_crypto_prices: Obtém preços históricos de uma criptomoeda.
  • get_current_crypto_price: Obtém o preço atual / mais recente de uma criptomoeda.

Configuração

Pré-requisitos

  • Python 3.10 ou superior
  • Gerenciador de pacotes uv

Instalação

  1. Clone este repositório:

    git clone https://github.com/financial-datasets/mcp-server
cd mcp-server

  2. Se você não tiver o uv instalado, instale-o:

    # macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
curl -LsSf https://astral.sh/uv/install.ps1 | powershell

  3. Instale as dependências:

    # Create virtual env and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx  # On Windows: uv add mcp[cli] httpx

  4. Configure as variáveis de ambiente:

    # Create .env file for your API keys
cp .env.example .env

# Set API key in .env
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

  5. Execute o servidor:

    uv run server.py

Conectando ao Claude Desktop

  1. Instale o Claude Desktop se ainda não o tiver

  2. Crie ou edite o arquivo de configuração do Claude Desktop:

    # macOS
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

  3. Adicione a seguinte configuração:

    {
  "mcpServers": {
    "financial-datasets": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/financial-datasets-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

    Substitua /path/to/uv pelo resultado de which uv e /absolute/path/to/financial-datasets-mcp pelo caminho absoluto para este projeto.

  4. Reinicie o Claude Desktop

  5. Agora você deve ver as ferramentas financeiras disponíveis no menu de ferramentas do Claude Desktop (ícone de martelo)

  6. Experimente fazer perguntas ao Claude como:

    • "Quais são as demonstrações de resultados recentes da Apple?"
    • "Mostre-me o preço atual das ações da Tesla"
    • "Obtenha preços históricos da MSFT de 01/01/2024 a 31/12/2024"