go_mcp_server_moex

Этот проект публикует выбранные эндпоинты MOEX ISS через сервер Model Context Protocol (MCP), реализованный с помощью библиотеки mcp-go.

Требования

• Go 1.23 или новее

Запуск

make run ARGS="-transport sse -addr :8181"

Для переключения транспорта (stdio, HTTP или SSE) и изменения адреса прослушивания используйте флаги. При запуске через Makefile передавайте значения через ARGS, например: make run ARGS="-transport http -addr :8181".

Флаги

• -t, -transport: транспорт (stdio, http или sse). По умолчанию: stdio.
• -addr: адрес прослушивания для HTTP/SSE. По умолчанию: :8080.

В режиме HTTP MCP-эндпоинт доступен по пути /mcp. В режиме SSE сервер публикует /sse (поток событий) и /message (для отправки запросов).

Переопределение через переменные окружения

• MOEX_LANG: значение параметра lang по умолчанию для ISS-запросов при запуске через stdio.
• MOEX_BASE_URL: переопределение базового URL ISS (полезно для тестирования).

Для HTTP и SSE те же значения можно задавать на уровне запроса через заголовки X-MOEX-LANG и X-MOEX-BASE-URL.

Документация для MOEX

• docs
• https://www.postman.com/tauc-2005/my-public/request/ytko7ja/
• https://iss.moex.com/iss/reference/

Поддерживаемые эндпойнты MOEX ISS (инструменты MCP)

• list_engines

  • MOEX: GET /iss/engines
  • Возвращает таблицу engines.

• list_markets

  • MOEX: GET /iss/engines/[engine]/markets
  • Аргументы: engine (обязателен), lang.

• list_boards

  • MOEX: GET /iss/engines/[engine]/markets/[market]/boards
  • Аргументы: engine (обязателен), market (обязателен), lang.

• list_securities

  • MOEX: GET /iss/engines/[engine]/markets/[market]/securities
  • Таблицы ответа: securities, marketdata, dataversion, marketdata_yields.
  • Аргументы MCP-инструмента:
    • Обязательные: engine, market
    • Фильтры: board (boardid), query (q)
    • Ограничение и сортировка: first (отдать N первых строк), sort_column, sort_order
    • Прочие фильтры: marketprice_board, primary_board, index, security_collection, previous_session
    • Списки: assets, sectypes, securities (CSV)
    • Подборки: leaders, nearest
    • Инкрементальные обновления: seqnum
    • Локализация: lang
  • Примечание: параметры limit и start для данного эндпойнта не документированы в ISS; используйте first.

• get_security_history

  • MOEX: GET /iss/history/engines/[engine]/markets/[market]/securities/[security]
  • Таблицы ответа: history, history.cursor.
  • Аргументы MCP-инструмента:
    • Обязательные: engine, market, security
    • Фильтры: board (boardid), from, till
    • Постраничность: limit, start
    • Сортировка и дополнительные фильтры: sort_order (asc|desc), sort_order_desc (устаревший), numtrades, sort_column, tradingsession, marketprice_board
    • Локализация: lang