MOEX MCP Server

MCP-сервер для доступа к данным Московской Биржи через ISS API.

Позволяет AI-ассистентам (Claude Code, Claude Desktop и др.) получать котировки, историю торгов, свечи, информацию о бумагах, индексах, валютных курсах и многое другое.

Требования

• Node.js 18+

Установка

git clone <repo-url> moex-mcp
cd moex-mcp
npm install
npm run build

Подключение

Claude Code

claude mcp add moex node /path/to/moex-mcp/dist/index.js

Claude Desktop / ручная настройка

Добавить в конфигурацию MCP-серверов:

{
  "mcpServers": {
    "moex": {
      "command": "node",
      "args": ["/path/to/moex-mcp/dist/index.js"]
    }
  }
}

Инструменты (20 шт.)

Поиск и информация о бумагах

Инструмент	Описание
search_securities	Поиск бумаг по тикеру, названию или ISIN
get_security_info	Спецификация бумаги: ISIN, номинал, даты, площадки
get_security_indices	Индексы, в которые входит бумага

Рыночные данные

Инструмент	Описание
get_market_data	Текущие данные: цена, объём, bid/ask, изменение
get_orderbook	Стакан заявок
get_recent_trades	Последние сделки
get_candles	OHLCV-свечи (1, 10, 60 мин или дневные)

Исторические данные

Инструмент	Описание
get_history	Итоги торгов за период
get_history_date_range	Доступный диапазон дат для бумаги
get_historical_candles	Исторические свечи за период

Справочники

Инструмент	Описание
list_engines	Торговые системы (stock, currency, futures и др.)
list_markets	Рынки торговой системы
list_boards	Режимы торгов

Аналитика и статистика

Инструмент	Описание
get_index_analytics	Аналитика индексов, состав и веса (IMOEX, RTSI)
get_currency_rates	Валютные курсы: фиксинг MOEX, ЦБ РФ, индикативные
get_market_turnovers	Обороты по рынкам
get_bond_yield_curve	Кривая бескупонной доходности (ZCYC)
get_futures_open_positions	Открытые позиции по фьючерсам

Корпоративные действия

Инструмент	Описание
get_dividends	История дивидендных выплат
get_coupons	График купонных выплат по облигациям

Примеры использования

После подключения сервера можно обращаться к данным биржи на естественном языке:

• «Найди акции Сбербанка»
• «Покажи текущую цену GAZP»
• «Дай историю торгов SBER за январь 2025»
• «Какие дивиденды платил Лукойл?»
• «Покажи состав индекса IMOEX»
• «Курс доллара по фиксингу ЦБ»
• «Свечи YNDX за последний месяц с интервалом 1 день»

Параметры по умолчанию

Большинство инструментов используют значения по умолчанию для удобства:

• engine = "stock" (фондовый рынок)
• market = "shares" (акции)

Для работы с другими рынками (облигации, валюта, фьючерсы) укажите параметры явно.

Аутентификация

Сервер работает без аутентификации. В этом режиме рыночные данные приходят с 15-минутной задержкой. Индексы всегда доступны в реальном времени.

Архитектура

Vertical Slice + Hexagonal (Ports & Adapters):

src/
├── index.ts                    # Composition root
├── server.ts                   # Регистрация MCP-инструментов
├── shared/
│   ├── ports/                  # Интерфейсы (порты)
│   ├── adapters/               # Реализации (адаптеры)
│   ├── pagination.ts           # Авто-пагинация
│   └── formatter.ts            # Форматирование для LLM
└── features/                   # 20 вертикальных слайсов
    └── <tool-name>/
        ├── schema.ts           # Zod-схема параметров
        ├── query.ts            # Бизнес-логика запроса
        └── handler.ts          # MCP-обработчик

Лицензия

MIT