convez.ai
MCP ServerFinanceiroAvançado
notryheart

MOEX AlgoPack MCP Server

notryheart/moex-algopack-mcp

Acesso via linguagem natural aos dados MOEX AlgoPack para análise quantitativa

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

CI License: Apache-2.0 Python 3.12+

Вы: покажи дисбаланс стакана по SBER за вчера

Claude → get_obstats(ticker="SBER", date="yesterday") →

📊 SBER · obstats · 2026-06-10 · строк всего: 203, показано: 35 (агрегировано до 30 мин) · источник: биржа

tradedatetradetimespread_bboimbalance_volvol_bvol_s…
2026-06-1010:00:003.10.1821.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_metricscancel-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

Ver o original no GitHub

Bom para

Relacionados