Financial Datasets

resmi

Yapay zeka ajanları için yapılmış borsa API'si

Financial Datasets MCP ile neler yapabilirsiniz?

  • Gelir tablolarını getir — Bir şirketin gelir tablolarını get_income_statements kullanarak alın.
  • Bilançoları getir — Bir şirketin bilançolarını get_balance_sheets kullanarak alın.
  • Nakit akış tablolarını getir — Bir şirketin nakit akış tablolarını get_cash_flow_statements kullanarak alın.
  • Güncel hisse senedi veya kripto fiyatlarını al — Bir ticker için en son fiyatı get_current_stock_price veya get_current_crypto_price ile sorgulayın.
  • Geçmiş hisse senedi veya kripto fiyatlarını al — Bir tarih aralığı için geçmiş fiyat verilerini get_historical_stock_prices veya get_historical_crypto_prices kullanarak çekin.
  • Şirket haberlerini al — Bir şirket için son haber makalelerini get_company_news ile alın.

Dokümantasyon

Financial Datasets MCP Sunucusu

Giriş

Bu, Financial Datasets üzerinden borsa verilerine erişim sağlayan bir Model Bağlam Protokolü (MCP) sunucusudur.

Claude ve diğer yapay zeka asistanlarının, gelir tablolarını, bilançoları, nakit akış tablolarını, hisse senedi fiyatlarını ve piyasa haberlerini doğrudan MCP arayüzü üzerinden almasına olanak tanır.

Mevcut Araçlar

Bu MCP sunucusu aşağıdaki araçları sağlar:

  • get_income_statements: Bir şirketin gelir tablolarını getirir.
  • get_balance_sheets: Bir şirketin bilançolarını getirir.
  • get_cash_flow_statements: Bir şirketin nakit akış tablolarını getirir.
  • get_current_stock_price: Bir şirketin güncel / en son fiyatını getirir.
  • get_historical_stock_prices: Bir şirketin geçmiş hisse senedi fiyatlarını getirir.
  • get_company_news: Bir şirketle ilgili haberleri getirir.
  • get_available_crypto_tickers: Mevcut tüm kripto para sembollerini getirir.
  • get_crypto_prices: Bir kripto para biriminin geçmiş fiyatlarını getirir.
  • get_historical_crypto_prices: Bir kripto para biriminin geçmiş fiyatlarını getirir.
  • get_current_crypto_price: Bir kripto para biriminin güncel / en son fiyatını getirir.

Kurulum

Ön Koşullar

  • Python 3.10 veya üzeri
  • uv paket yöneticisi

Kurulum Adımları

  1. Bu depoyu klonlayın:

    git clone https://github.com/financial-datasets/mcp-server
    cd mcp-server
    
  2. Eğer uv yüklü değilse, yükleyin:

    # macOS/Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    # Windows
    curl -LsSf https://astral.sh/uv/install.ps1 | powershell
    
  3. Bağımlılıkları yükleyin:

    # 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. Ortam değişkenlerini ayarlayın:

    # 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. Sunucuyu çalıştırın:

    uv run server.py
    

Claude Desktop'a Bağlanma

  1. Eğer henüz yüklü değilse Claude Desktop uygulamasını yükleyin

  2. Claude Desktop yapılandırma dosyasını oluşturun veya düzenleyin:

    # macOS
    mkdir -p ~/Library/Application\ Support/Claude/
    nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
    
  3. Aşağıdaki yapılandırmayı ekleyin:

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

    /path/to/uv kısmını which uv sonucuyla ve /absolute/path/to/financial-datasets-mcp kısmını bu projenin mutlak yolu ile değiştirin.

  4. Claude Desktop uygulamasını yeniden başlatın

  5. Artık Claude Desktop'ın araçlar menüsünde (çekiç simgesi) finansal araçları görmelisiniz

  6. Claude'a şu tür sorular sormayı deneyin:

    • "Apple'ın son gelir tabloları nelerdir?"
    • "Tesla hissesinin güncel fiyatını göster"
    • "MSFT için 2024-01-01 ile 2024-12-31 arası geçmiş fiyatları getir"