MOEX AlgoPack MCP Server
notryheart/moex-algopack-mcp
Acesso via linguagem natural aos dados MOEX AlgoPack para análise quantitativa
Ver no GitHubServidor MCP que conecta agentes Claude aos dados de microestrutura do mercado da Bolsa de Moscou (MOEX). Fornece acesso a estatísticas de negociação, fluxo de ordens, profundidade de livro e métricas derivadas em tempo real, com agregação inteligente e cache persistente para contexto de LLM otimizado.
Instalação
npx convez-ai notryheart/moex-algopack-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise de desequilíbrio e profundidade do book de ordens em tempo real
- Screening de anomalias e detecção de movimentos de mercado anormais
- Cálculo de métricas derivadas: cancel-to-trade ratio, volatilidade realizada, iliquidez de Amihud
- Pesquisa quantitativa e backtesting com dados de microestrutura autênticos
Veredito

Ferramenta especializada e robusta para pesquisadores quantitativos e traders que operam no mercado russo. Cache inteligente, agregação semântica e retry resiliente fazem dela produção-ready, mas requer subscrição MOEX AlgoPack para funcionalidade completa.
README
A tradução para o português deste README ainda está na fila.
moex-algopack-mcp
MCP-сервер для MOEX AlgoPack: рыночная микроструктура Московской биржи — естественным языком, прямо из Claude.
Вы: покажи дисбаланс стакана по SBER за вчера
Claude →
get_obstats(ticker="SBER", date="yesterday")→📊 SBER · obstats · 2026-06-10 · строк всего: 203, показано: 35 (агрегировано до 30 мин) · источник: биржа
tradedate tradetime spread_bbo imbalance_vol vol_b vol_s … 2026-06-10 10:00:00 3.1 0.182 1.2 млн 832.4 тыс … «Утром в стакане преобладали покупатели (imbalance_vol до +0.18), после 15:00 дисбаланс ушёл в минус…»
Больше сценариев — в examples/dialogs.md.
Что умеет
LLM-агент (Claude Desktop, Claude Code, любой MCP-клиент) получает доступ к 5-минутным агрегатам AlgoPack и публичным свечам ISS:
| Tool | Что возвращает |
|---|---|
get_tradestats | поток сделок: цены, объёмы, buy/sell-разрезы, VWAP, дисбаланс агрессора |
get_orderstats | поток заявок: выставлено/снято (штуки, лоты, рубли), цены заявок |
get_obstats | стакан: спреды, глубина, ликвидность, дисбаланс заявок |
get_candles | свечи OHLCV — работает без подписки AlgoPack |
get_futoi | открытые позиции по фьючерсам: физлица (FIZ) vs юрлица (YUR) |
get_market_snapshot | дневной срез датасета по всем бумагам рынка (скрининг «у каких бумаг…») |
compute_derived_metrics | cancel-to-trade ratio, order flow imbalance, относительный спред, дисбаланс стакана, неликвидность Амихуда, реализованная волатильность — каждая с формулой и ссылкой на источник |
screen_anomalies | топ-N бумаг по z-score метрики против её собственной 20-дневной истории |
list_available_metrics | машиночитаемый глоссарий: каждая колонка каждого датасета (ru/en, единицы, агрегация) |
Плюс MCP-ресурсы: algopack://about, algopack://glossary, algopack://tickers/{EQ|FX|FO}.
Сделано для LLM-контекста
- ответы — компактные markdown-таблицы ≤ 50 строк; длинные ряды автоматически агрегируются до 15м/30м/1ч/1д по семантике колонок (объёмы — сумма, open/close — first/last, VWAP — взвешенная по объёму) с пометкой в метаданных;
- у каждого инструмента
format: table | json | summary(summary — 3–5 предложений статистики: тренд, min/max/среднее, выбросы |z|>3); - числа округляются по-человечески: цены — по точности инструмента с биржи, объёмы —
52.0 млн,1.23 млрд; - ошибки понятны модели и содержат следующее действие: «выходной → ближайший торговый день…», «тикер не найден → возможно, вы имели в виду…», «нет подписки → доступны свечи».
Надёжность
- retry с экспоненциальным backoff (+jitter) на сетевых ошибках и 5xx; 401/403 не ретраятся — сразу понятное сообщение про токен/подписку;
- клиентский rate limit (token bucket, по умолчанию 3 rps);
- Parquet-кэш: прошедшие торговые дни — навсегда, сегодняшний — TTL 5 минут; пустые праздничные дни тоже кэшируются; диапазоны дотягиваются только «дырами»;
- graceful degradation:
realized_volatilityиamihud_illiquidityбез подписки считаются из публичных свечей с пометкой в ответе.
Установка
Нужны Python ≥ 3.12 и uv.
git clone https://github.com/notryheart/moex-algopack-mcp.git
cd moex-algopack-mcp
uv sync
uv run python -m algopack_mcp # проверка: сервер поднимается на stdio
Авторизация AlgoPack
Подписка покупается на data.moex.com (для физлиц есть недорогой тариф). Сервер читает учётные данные только из переменных окружения (см. .env.example):
MOEX_ALGOPACK_TOKEN— API-ключ (рекомендуется), илиMOEX_USERNAME+MOEX_PASSWORD— логин/пароль passport.moex.com.
Без авторизации работают свечи, список инструментов и глоссарий — сервер честно скажет, что для остального нужна подписка.
Claude Desktop
claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"moex-algopack": {
"command": "uv",
"args": ["run", "--directory", "/абсолютный/путь/к/moex-algopack-mcp", "python", "-m", "algopack_mcp"],
"env": {
"MOEX_ALGOPACK_TOKEN": "ваш_токен"
}
}
}
}
Claude Code
claude mcp add moex-algopack \
--env MOEX_ALGOPACK_TOKEN=ваш_токен \
-- uv run --directory /абсолютный/путь/к/moex-algopack-mcp python -m algopack_mcp
HTTP-транспорт (опционально)
uv run python -m algopack_mcp --transport streamable-http # http://127.0.0.1:8000/mcp
Архитектура
src/algopack_mcp/
client/ # слой данных: обёртка над moexalgo
api.py # retry + backoff, token bucket, маппинг ошибок, дневной gap-fetch
cache.py # Parquet-кэш: история — навсегда, сегодня — TTL 5 мин, negative cache
validation.py# тикеры, даты, торговые дни, подсказки
domain/ # доменный слой (чистые функции, без сети)
glossary.py # каждая колонка каждого датасета: ru/en, единицы, правило агрегации
metrics.py # производные метрики: формула + ссылка на источник в докстринге
aggregate.py # групповая агрегация по правилам глоссария
screening.py # z-score скрининг аномалий
server/ # MCP-слой (не знает про HTTP)
tools.py # 9 инструментов с подробными описаниями для LLM
resources.py # about / glossary / tickers
formatting.py# таблицы ≤50 строк, downsample, суффиксы, summary
Слои разделены жёстко: MCP-слой не знает про HTTP, слой данных — про MCP; границы
типизированы pydantic-моделями. Сетевые вызовы только в client/api.py.
Заметки по реальному устройству moexalgo/ISS и принятые решения — в NOTES.md.
Разработка
uv run pytest # юнит-тесты (сеть замокана)
uv run pytest -m integration # интеграционные против реального ISS (свечи — без токена)
uv run ruff check . && uv run ruff format --check .
npx @modelcontextprotocol/inspector uv run python -m algopack_mcp # ручная проверка
CI (GitHub Actions): ruff + pytest на Python 3.12 и 3.13 при каждом push.
Дисклеймер о данных
Этот сервер не публикует и не редистрибутирует данные MOEX AlgoPack. Он лишь
предоставляет авторизованному пользователю программный доступ к его собственной
подписке; данные не покидают машину пользователя (локальный кэш — в
~/.cache/algopack-mcp). Использование данных регулируется условиями MOEX.
Это не инвестиционная рекомендация.
English
MCP server for MOEX AlgoPack — Moscow Exchange market microstructure data (5-minute trade/order/orderbook aggregates, futures open interest by client type) exposed to LLM agents via the Model Context Protocol.
Ask Claude "show me SBER order book imbalance for yesterday" and it calls
get_obstats(ticker="SBER", date="yesterday"), getting a compact markdown table
(auto-downsampled to ≤50 rows with semantics-aware aggregation) or a 3–5 sentence
statistical summary (format="summary").
Tools: get_tradestats, get_orderstats, get_obstats, get_candles (public
ISS, no subscription needed), get_futoi (retail vs institutional futures
positioning), get_market_snapshot (whole-market daily cross-section),
compute_derived_metrics (cancel-to-trade ratio, order flow imbalance, relative
spread, book imbalance, Amihud illiquidity, realized volatility — each a pure function
documented with formula and academic source), screen_anomalies (top-N tickers by
z-score vs their own 20-day history), list_available_metrics (bilingual
machine-readable glossary). Resources: algopack://about, algopack://glossary,
algopack://tickers/{market}.
Reliability: exponential-backoff retries, client-side token-bucket rate limiting, Parquet cache (historical days cached forever, today with 5-min TTL), graceful degradation to public candles when the AlgoPack subscription is missing, friendly actionable errors (weekend → nearest trading day, typo → ticker suggestions).
Install: uv sync, then add to Claude Desktop / Claude Code with
MOEX_ALGOPACK_TOKEN (or MOEX_USERNAME/MOEX_PASSWORD) in env — see Russian
section above for config snippets. Candles work without any credentials.
Data disclaimer: this server does not republish or redistribute AlgoPack data; it only gives the authorized subscriber programmatic access to their own subscription. Data never leaves the user's machine. Not investment advice.
License
Apache-2.0 © 2026 Yaroslav Antonov