Financial Datasets

resmi

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

GitHub
2.2k

Financial Datasets MCP ile neler yapabilirsiniz?

  • 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.

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"