hightemp/go_mcp_server_moex
If you are the rightful owner of go_mcp_server_moex and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project publishes selected MOEX ISS endpoints through a Model Context Protocol (MCP) server implemented using the mcp-go library.
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
Поддерживаемые эндпойнты 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