yfinance-mcp

Живые рыночные данные для вашего ИИ. Сервер Model Context Protocol, который даёт Claude (или любому MCP-клиенту) котировки в реальном времени, историю OHLCV, полные цепочки опционов, новости и сравнение нескольких тикеров. Бесплатно, без API-ключа.

Почему

LLM отвечают на рыночные вопросы, угадывая по обучающим данным. Подключите этот сервер один раз — и они перестанут гадать:

• «Сколько сейчас стоит Apple?» → живая котировка вместо устаревшей галлюцинации

• «Покажи опционы AAPL с истечением в следующем месяце» → реальные страйки с IV и открытым интересом

• «NVDA против AMD против INTC в этом году?» → фактические доходности, волатильность, просадки, рассчитанные на основе данных

• «Есть свежие новости о PLTR?» → заголовки со ссылками, на которые можно сослаться

Related MCP server: YFinance MCP Server

Инструменты

Ответы — в формате JSON, усечённые до удобных для LLM размеров (опционы ограничены 60 строками на сторону), со сводной статистикой, чтобы модель сначала анализировала агрегаты, а не сырые бары.

Установка

git clone https://github.com/saksham10arora-dotcom/yfinance-mcp
cd yfinance-mcp
python3 -m venv .venv && .venv/bin/pip install fastmcp yfinance

Claude Desktop / любой MCP-клиент

Добавьте в claude_desktop_config.json (File → Settings → Developer → Edit Config):

{
  "mcpServers": {
    "yfinance": {
      "command": "/absolute/path/to/yfinance-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/yfinance-mcp/server.py"]
    }
  }
}

Перезапустите Claude Desktop. Инструменты появятся под значком 🔨. Спросите о любом тикере.

Проверка без MCP-клиента

./.venv/bin/python -c "import server; print(server.get_quote('AAPL'))"

CI выполняет то же рукопожатие stdio, что и GitHub, при каждом пуше, поэтому main всегда соответствует протоколу.

FAQ

Данные в реальном времени? Данные Yahoo Finance: почти реальное время для американских акций, задержка для некоторых международных бирж. Подходит для исследований и чата, но не для исполнения ордеров.

Это стоит денег? Нет. Никакого API-ключа, никакого аккаунта с лимитами, ничего настраивать не нужно.

Почему бы просто не вставить код yfinance в чат? Можно. Это убирает цикл копирования-вставки и позволяет модели решать, какой инструмент вызвать для каждого вопроса, включая многошаговые («сравни эти пять тикеров, затем вытащи цепочку для самого волатильного»).

Windows? Работает. Укажите в конфиге путь к .venv\Scripts\python.exe и используйте двойные обратные слэши в JSON.

Устранение неполадок

• Значок инструмента пропал после перезапуска: пути в конфиге должны быть абсолютными; относительные пути молча не работают.

• no data for <ticker>: делистингованная или неправильно написанная бумага; проверьте Yahoo Finance в браузере.

• Ограничение частоты запросов после интенсивного использования: подождите несколько минут; Yahoo ограничивает всплески.

Сравнение с альтернативами

Лицензия

MIT. Не является инвестиционной рекомендацией; ИИ, читающий ваш портфель, не является фидуциарием.