MCP-сервер Yahoo Finance

👁 PyPI version
👁 Python
👁 CI
👁 License: MIT

Сервер Model Context Protocol (MCP), который предоставляет ИИ-ассистентам доступ к данным Yahoo Finance через yfinance. Запрашивайте биржевую информацию, финансовые новости, рейтинги секторов и создавайте профессиональные финансовые графики — всё прямо из вашего ИИ-чата.

Возможности

• Биржевые данные — информация о компании, финансовые показатели, метрики оценки, дивиденды и торговые данные

• Финансовая отчетность — отчет о прибылях и убытках и бухгалтерский баланс с историческими данными (EBIT, инвестированный капитал и т. д.)

• Финансовые новости — последние новостные статьи и пресс-релизы для любого тикера

• Поиск — поиск акций, ETF и новостей на Yahoo Finance

• Рейтинги секторов — лучшие ETF, взаимные фонды, компании, лидеры роста и наиболее эффективные компании по секторам

• История цен — исторические данные OHLCV в виде таблиц Markdown или профессиональных графиков

• Создание графиков — свечные графики, VWAP и профиль объема, возвращаемые в виде изображений WebP

Related MCP server: MCP Yahoo Finance

Инструменты

yfinance_get_ticker_info

Получение исчерпывающих биржевых данных, включая информацию о компании, финансовые показатели, торговые метрики и данные об управлении.

Возвращает: JSON-объект с деталями компании, ценовыми данными, метриками оценки, торговой информацией, дивидендами, финансовыми показателями и индикаторами эффективности.

yfinance_get_ticker_news

Получение последних новостных статей и пресс-релизов для конкретной акции.

Возвращает: JSON-массив новостных элементов с заголовком, кратким содержанием, датой публикации, источником, URL и миниатюрой.

yfinance_search

Поиск акций, ETF и новостных статей на Yahoo Finance.

Возвращает: Соответствующие котировки и/или результаты новостей в зависимости от search_type.

yfinance_get_top

Получение списка лучших финансовых организаций в рамках рыночного сектора.

Возвращает: JSON-массив лучших организаций с соответствующими метриками.

Поддерживаемые сектора

Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities

yfinance_get_price_history

Получение исторических ценовых данных и (опционально) создание графиков технического анализа.

Типы графиков:

Возвращает:

• Без chart_type: Таблица Markdown со столбцами Date, Open, High, Low, Close, Volume, Dividends и Stock Splits.

• С chart_type: Изображение WebP в кодировке Base64 для эффективного использования токенов.

yfinance_get_financials

Получение финансовой отчетности (отчет о прибылях и убытках, бухгалтерский баланс и отчет о движении денежных средств) с историческими данными.

Возвращает: JSON-объект с данными отчета о прибылях и убытках, бухгалтерского баланса и движения денежных средств для каждого отчетного периода.

• Поля отчета о прибылях и убытках: EBIT, чистая прибыль, резерв на уплату налогов, прибыль до налогообложения, процентные расходы, общая выручка, операционная прибыль, EBITDA, нормализованная прибыль

• Поля бухгалтерского баланса: Собственный капитал, общий долг, денежные средства и их эквиваленты, инвестированный капитал, чистый долг, общие активы, общие обязательства за вычетом доли меньшинства, чистые материальные активы, материальная балансовая стоимость

• Поля отчета о движении денежных средств: Операционный денежный поток, свободный денежный поток, капитальные затраты, чистая прибыль от продолжающейся деятельности, амортизация, изменение оборотного капитала, выплаченные денежные дивиденды

Использование

Через uv (рекомендуется)

1. Установите uv

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

{
 "mcpServers": {
 "yfmcp": {
 "command": "uvx",
 "args": ["yfmcp@latest"]
 }
 }
}

Через Docker

{
 "mcpServers": {
 "yfmcp": {
 "command": "docker",
 "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
 }
 }
}

Из исходного кода

1. Клонируйте репозиторий и установите зависимости:

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync

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

{
 "mcpServers": {
 "yfmcp": {
 "command": "uv",
 "args": [
 "run",
 "--directory",
 "/path/to/yfinance-mcp",
 "yfmcp"
 ]
 }
 }
}

Замените /path/to/yfinance-mcp на фактический путь к вашему клонированному репозиторию.

Разработка

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

• Python ≥ 3.12

• Менеджер пакетов uv

Настройка

uv sync --extra dev

Линтинг и форматирование

uv run ruff check .
uv run ruff format .

Проверка типов

uv run ty check src tests

Тестирование

uv run pytest -v -s --cov=src tests

Демонстрационный чат-бот

Смотрите демонстрационный чат-бот в специальном репозитории: yfinance-mcp-demo

Участники

Создано с помощью contrib.rocks.

Лицензия

Этот проект лицензирован по лицензии MIT.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• yfinance_get_financialsA
• yfinance_get_holdersA
• yfinance_get_option_chainA
• yfinance_get_option_datesA
• yfinance_get_price_historyA
• yfinance_get_ticker_infoA
• yfinance_get_ticker_newsA
• yfinance_get_topA