okama-mcp — это MCP-сервер (Model Context Protocol — открытый стандарт от Anthropic, через который ИИ-ассистенты подключаются к внешним инструментам и данным). Он даёт ассистентам — Claude Desktop, Claude Code, Cursor, Codex и любому MCP-клиенту — прямой доступ к инструментам библиотеки okama: бэктесты портфелей, Monte Carlo, эффективная граница, графики. Python-кода на вашей стороне не нужно — ассистент сам вызывает инструменты, а они обращаются к okama.
Вышла версия 1.5.0: заметно расширен блок Monte Carlo и пенсионного планирования (изъятия и пополнения) — теперь доступно 45 инструментов.
Основные полезности MCP okama
Со всеми инструментами можно работать на естественном языке — просто опишите задачу своими словами, ассистент сам подберёт нужный вызов. Вот основные сценарии и примеры промптов.
Поиск активов и данные
Тикеры, описания, история котировок, дивиденды.
«Найди тикер фонда на золото и ETF на индекс S&P 500»
«Покажи дивидендную историю по VNQ.US за 10 лет»
«Сравни SPY.US, GLD.US и BND.US: доходность, риск, корреляции»
Анализ и бэктест портфеля
Доходность (CAGR), риск, просадки, VaR/CVaR, коэффициенты Шарпа и Сортино, скользящие метрики.
«Сделай бэктест портфеля 60% акции / 40% облигации с 2010 года»
«Сравни мой портфель с бенчмарком: доходность, волатильность, максимальная просадка»
«Построй график просадок и скользящую доходность за 5 лет»
Прогноз Monte Carlo и пенсионное планирование
Прогноз будущего капитала с изъятиями и пополнениями, оценка вероятностей и срока жизни портфеля.
«Прогноз Monte Carlo: изымаю 50 000 ₽/мес с поправкой на инфляцию 25 лет — хватит ли капитала?»
«Какую сумму можно безопасно изымать, чтобы денег хватило на 30 лет?»
«На сколько лет хватит портфеля при изъятии 5% в год и когда он обнулится?»
Распределения доходностей (новое в 1.5.0)
Подгонка нормального, логнормального или распределения Стьюдента (тяжёлые хвосты), тесты нормальности, диагностические графики.
«Насколько доходности моего портфеля отклоняются от нормального распределения?»
«Какое распределение лучше описывает мои данные?» (тесты Харке–Бера и Колмогорова–Смирнова)
«Покажи Q-Q график и гистограмму доходностей с подогнанной кривой»
Оптимизация: эффективная граница
Эффективная граница, портфели с максимальным Шарпом (касательный), минимальным риском, максимальной диверсификацией; карта переходов.
«Построй эффективную границу для SPY, BND и GLD»
«Найди портфель с максимальным коэффициентом Шарпа»
«Покажи портфель минимального риска и карту переходов весов»
Макроданные
«Покажи инфляцию доллара за последние 10 лет»
«Какая сейчас ключевая ставка ФРС и ЦБ РФ?»
Графики
Инструменты-графики возвращают готовые PNG (вэлс-индекс, просадки, веер Monte Carlo, эффективная граница, сравнение активов и др.) — клиенты вроде Claude Desktop показывают их прямо в чате.
Как установить
okama-mcp подключается как MCP-сервер к вашему ИИ-ассистенту. Есть два пути.
Проще всего — попросить ИИ-ассистента
Просто скажите ему: «Установи MCP okama» — современные ассистенты умеют сами прописать сервер в свой конфиг. Чтобы ассистент выполнил настройку сам, без лишних подтверждений, включите автономный режим: в Claude Code — auto mode; у других ассистентов (Cursor, Codex и т. п.) есть аналогичные режимы автономной работы.
Вручную
Нужен установленный uv (он даёт команду uvx) — отдельно ставить Python не требуется, uvx сам скачает пакет.
Claude Desktop — добавьте в claude_desktop_config.json:
{
"mcpServers": {
"okama": { "command": "uvx", "args": ["okama-mcp", "stdio"] }
}
}
и перезапустите приложение.
Claude Code:
claude mcp add --scope user okama -- uvx okama-mcp stdio
Cursor — добавьте тот же блок mcpServers в .cursor/mcp.json (или ~/.cursor/mcp.json для всех проектов).
Codex:
codex mcp add okama -- uvx okama-mcp stdio
Конфиги для всех клиентов — в README.
Как обновиться
Ничего делать не нужно: uvx okama-mcp подтянет новую версию сам, а MCP-клиенты увидят её в каталоге.
Ссылки
- Репозиторий: GitHub - mbk-dev/okama-mcp: MCP server providing investment analysis tools backed by the okama Python library · GitHub
- Страница проекта: https://mcp.okama.io/
- Полный список изменений: Release v1.5.0 — full MC/DCF/distribution parity (12 new tools) · mbk-dev/okama-mcp · GitHub