Financial Datasets

resmi

Stock market API made for AI agents

GitHub
2.2k

Apa yang bisa Anda lakukan dengan 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.

Dokumentasi

Server MCP Financial Datasets

Pengantar

Ini adalah server Model Context Protocol (MCP) yang menyediakan akses ke data pasar saham dari Financial Datasets.

Server ini memungkinkan Claude dan asisten AI lainnya untuk mengambil laporan laba rugi, neraca, laporan arus kas, harga saham, dan berita pasar secara langsung melalui antarmuka MCP.

Alat yang Tersedia

Server MCP ini menyediakan alat-alat berikut:

  • get_income_statements: Mendapatkan laporan laba rugi untuk suatu perusahaan.
  • get_balance_sheets: Mendapatkan neraca untuk suatu perusahaan.
  • get_cash_flow_statements: Mendapatkan laporan arus kas untuk suatu perusahaan.
  • get_current_stock_price: Mendapatkan harga terkini/terbaru dari suatu perusahaan.
  • get_historical_stock_prices: Mendapatkan harga saham historis untuk suatu perusahaan.
  • get_company_news: Mendapatkan berita untuk suatu perusahaan.
  • get_available_crypto_tickers: Mendapatkan semua ticker kripto yang tersedia.
  • get_crypto_prices: Mendapatkan harga historis untuk mata uang kripto.
  • get_historical_crypto_prices: Mendapatkan harga historis untuk mata uang kripto.
  • get_current_crypto_price: Mendapatkan harga terkini/terbaru dari mata uang kripto.

Penyiapan

Prasyarat

  • Python 3.10 atau lebih tinggi
  • Manajer paket uv

Instalasi

  1. Kloning repositori ini:

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

  2. Jika Anda belum menginstal uv, instal:

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

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

  3. Instal dependensi:

    # 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. Atur variabel lingkungan:

    # 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. Jalankan server:

    uv run server.py

Menghubungkan ke Claude Desktop

  1. Instal Claude Desktop jika Anda belum melakukannya

  2. Buat atau edit berkas konfigurasi Claude Desktop:

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

  3. Tambahkan konfigurasi berikut:

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

    Ganti /path/to/uv dengan hasil dari which uv dan /absolute/path/to/financial-datasets-mcp dengan jalur absolut ke proyek ini.

  4. Mulai ulang Claude Desktop

  5. Anda sekarang seharusnya melihat alat keuangan tersedia di menu alat Claude Desktop (ikon palu)

  6. Coba tanyakan kepada Claude pertanyaan seperti:

    • "Apa laporan laba rugi terbaru Apple?"
    • "Tunjukkan harga saham Tesla saat ini"
    • "Dapatkan harga historis untuk MSFT dari 2024-01-01 hingga 2024-12-31"