Financial Datasets

официальный

API фондового рынка, созданная для AI-агентов

GitHub
2.2k

Что можно делать с 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.

Документация

Financial Datasets MCP Server

Введение

Это сервер Model Context Protocol (MCP), предоставляющий доступ к данным фондового рынка из Financial Datasets.

Он позволяет Claude и другим AI-ассистентам получать отчёты о прибылях и убытках, балансовые отчёты, отчёты о движении денежных средств, цены акций и рыночные новости напрямую через интерфейс MCP.

Доступные инструменты

Этот MCP-сервер предоставляет следующие инструменты:

  • get_income_statements: Получить отчёты о прибылях и убытках компании.
  • get_balance_sheets: Получить балансовые отчёты компании.
  • get_cash_flow_statements: Получить отчёты о движении денежных средств компании.
  • get_current_stock_price: Получить текущую / последнюю цену акций компании.
  • get_historical_stock_prices: Получить исторические цены акций компании.
  • get_company_news: Получить новости компании.
  • get_available_crypto_tickers: Получить все доступные тикеры криптовалют.
  • get_crypto_prices: Получить исторические цены криптовалюты.
  • get_historical_crypto_prices: Получить исторические цены криптовалюты.
  • get_current_crypto_price: Получить текущую / последнюю цену криптовалюты.

Настройка

Предварительные требования

  • Python 3.10 или выше
  • Менеджер пакетов uv

Установка

  1. Клонируйте этот репозиторий:

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

  2. Если у вас не установлен uv, установите его:

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

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

  3. Установите зависимости:

    # 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. Настройте переменные окружения:

    # 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. Запустите сервер:

    uv run server.py

Подключение к Claude Desktop

  1. Установите Claude Desktop, если ещё не сделали этого

  2. Создайте или отредактируйте файл конфигурации Claude Desktop:

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

  3. Добавьте следующую конфигурацию:

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

    Замените /path/to/uv на результат which uv и /absolute/path/to/financial-datasets-mcp на абсолютный путь к этому проекту.

  4. Перезапустите Claude Desktop

  5. Теперь вы должны увидеть финансовые инструменты в меню инструментов Claude Desktop (иконка молотка)

  6. Попробуйте задать Claude вопросы, например:

    • "Какие последние отчёты о прибылях и убытках Apple?"
    • "Покажи текущую цену акций Tesla"
    • "Получи исторические цены MSFT с 2024-01-01 по 2024-12-31"