MOEX MCP сервер с кэшем и повторами
MOEX MCP сервер
Опубликованный в npm MCP-сервер ISS Мосбиржи с 10 инструментами, SQLite-кэшем и отказоустойчивыми повторами запросов
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает данные ISS, не размещает заявки
- Не подключается к брокерским счетам
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/izevg-moex-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio moex-mcp -- npx -y --package=@ru-financial-tools/moex-mcp moex-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"moex-mcp","type":"stdio","command":"npx","args":["-y","--package=@ru-financial-tools/moex-mcp","moex-mcp"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"moex-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add moex-mcp -- npx -y --package=@ru-financial-tools/moex-mcp moex-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.moex-mcp]
command = "npx"
args = ["-y", "--package=@ru-financial-tools/moex-mcp", "moex-mcp"]Если файл уже есть, допишите блок в конец.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"moex-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"moex-mcp": {
"command": "npx",
"args": [
"-y",
"--package=@ru-financial-tools/moex-mcp",
"moex-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
LOG_LEVELнеобязательнаяMOEX_ISS_BASE_URLнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь в конфигурацию MCP клиента команду npx -y --package=@ru-financial-tools/moex-mcp moex-mcp, при желании задай переменные LOG_LEVEL и MOEX_ISS_BASE_URL, npm-пакет установится автоматически при первом запуске.
Другие способы из описания автора
npx -y --package=@ru-financial-tools/moex-mcp moex-mcpЗапуск без установки, вариант 1 из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер опубликован в npm под именем @ru-financial-tools/moex-mcp и запускается без установки через npx. Десять инструментов покрывают ключевые разделы ISS API: справочники движков, рынков и режимов торгов, поиск бумаг, рыночные данные, стакан заявок, лента сделок с режимами recent и by_date, свечи, историю торгов, индексы со списком, значением, историей и составом, обороты по рынку и своду и сводный справочник reference dicts. Клиент делает до пяти повторов с экспоненциальной задержкой и джиттером при ошибках 408, 429 и 5xx, а ответы кэшируются через Keyv на SQLite, кэш можно отключить или задать свой путь. Есть три готовых промпта: moex_quickstart, moex_resources_help и moex_find_board.
Для кого. Для разработчиков, которым нужен зрелый MOEX MCP-сервер с кэшем и повторами без сборки из исходников.
Подходит, если
- Нужен запуск одной командой npx без клонирования репозитория
- Важны устойчивость к перегрузкам ISS: повторы запросов и кэш ответов
- Нужны стакан заявок и лента сделок по конкретной дате, а не только текущие котировки
Не подходит, если
- Нужны фьючерсы FORTS или дивиденды: этих разделов ISS API здесь нет
- Не устраивает локальный SQLite-кэш и хочется полностью статeless сервера
Пример запроса к агенту
Покажи стакан заявок по GAZP и последние сделки за 15 января 2025 годаОграничения
0 звезд, автор один, больше года без обновлений. Нет инструментов по фьючерсам, облигациям и дивидендам, набор ограничен базовыми разделами ISS. Кэш SQLite по умолчанию хранится в локальном файле, при частой смене данных это может отдавать устаревшие значения до истечения TTL.
Как отключить. Удалите блок moex-mcp из конфигурации MCP клиента и при желании сотрите локальный файл SQLite-кэша.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| MOEX_ISS_BASE_URL | Базовый URL ISS, по умолчанию https://iss.moex.com/iss |
| LOG_LEVEL | Уровень логирования: debug или info |
| MOEX_CACHE_DISABLED | Значение 1 полностью отключает кэш Keyv на SQLite |
| MOEX_CACHE_PATH | Свой путь к файлу кэша SQLite |
Проверка безопасности
- Только читает данные ISS, не размещает заявки
- Не подключается к брокерским счетам
Коротко о README
README на русском перечисляет десять инструментов по разделам ISS API, дает два способа установки через npx и локальный npm i, конфигурацию для Cursor с переменными LOG_LEVEL и MOEX_ISS_BASE_URL, настройки кэша Keyv на SQLite, примеры вызова каждого инструмента и описание отказоустойчивости клиента: до пяти повторов с задержкой от 150 мс до 2 с и джиттером на сетевых и HTTP-ошибках. В репозитории также есть CONTRIBUTING.md и SECURITY.md. Лицензия MIT.
Частые вопросы
Нужна ли предварительная установка пакета?
Нет, npx -y скачивает и запускает пакет @ru-financial-tools/moex-mcp автоматически при каждом старте.
Можно ли отключить кэш?
Да, переменная MOEX_CACHE_DISABLED=1 отключает кэш Keyv на SQLite полностью.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики