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