В 3.1.0 MCP-сервер получает 52 инструмента в обычной установке (70 — если включены
локальные клиентские инструменты и выгрузка в Excel) и учится держать персональные
данные клиентов за явным переключателем, который включает человек, а не модель.
Что нового
Персональные данные остаются у вас
По умолчанию MCP-сервер работает в режиме anonymous: он видит только псевдонимы вида
c-0001-name, а любые записи в базу клиентов отклоняются. Полный доступ включается
инструментом client_data_mode_set с mode="personal_data" и выключается обратно тем же
инструментом; client_data_mode_get показывает, какой режим действует сейчас.
- Режим хранится в файле рядом с базой (
<база>.mcp-access.json), общий для всех
подключений и сохраняется после перезапуска сервера. Персональных данных в нём нет. - Записи в базу выполняет сам okama Planner через свой API: MCP-сервер не подключает
драйвер базы, не пишет SQL и не проверяет права доступа сам. - Отчёты и прогнозы остаются анонимными: выгрузка принимает только неизменённый
результат с подписью, иначе отказывает. - Ошибки приходят одной короткой фразой на языке запроса — без значений полей, путей к
файлам и имён таблиц. - По HTTP локальные клиентские инструменты по-прежнему не выставляются.
Расчёты стали быстрее
Тяжёлые вычисления делает okama, и новые установки получают okama 4.0.1 с
переработанным батчингом. Замеры на Ryzen 7 8845H, медиана пяти прогонов:
| Что считается | Было (okama 4.0.0) | Стало (okama 4.0.1) |
|---|---|---|
индекс благосостояния с изъятиями (get_dcf_wealth_index) |
54.7 мс | 6.8 мс |
| rolling CAGR по трём активам, окно 60 месяцев | 37.9 мс | 2.3 мс |
Цифры зависят от нагрузки, их не нужно перемножать. Для прогноза Монте-Карло
(30 лет, 8 192 сценария) разница в пределах разброса, поэтому ускорения там не обещаю.
Работа с локальными моделями
Правки интерфейса, которые нашлись при работе с локальной моделью, вышли ещё в 3.0.0:
полные вложенные схемы в tools/list, описания пространств имён, подсказки по
исправлению RATE/INFL/RATIO, ранжирование точных совпадений и пагинация поиска.
В 3.1.0 к этому добавились две вещи:
- отказ по персональным данным приходит одной локализованной фразой, а не общим
сообщением, на которое модель начинает ретраить; - текущий режим доступа модель может прочитать сама, а не угадывать по ошибкам.
Воспроизводимый прогон с моделью, о которой писал тестировщик, пока открыт — сравнения
по конкретным моделям мы не заявляем.
Как установить
uvx okama-mcp stdio
Дальше — как обычно: команда добавляется в конфигурацию MCP-клиента (Claude Desktop,
Claude Code, Cursor, Codex и любой другой), после чего ассистент видит инструменты.
Вместе с MCP-сервером ставится okama Planner 0.5.1: его локальные интерфейсы — форма
ввода клиента, журнал встреч и просмотр старой базы — теперь на пяти языках (английский,
русский, немецкий, испанский, упрощённый китайский). MCP-серверу это ничего не меняет,
API и схема базы те же.
Как обновить
pip install -U okama-mcp okama
Перезапустите MCP-клиент, чтобы он перечитал схемы инструментов. Существующие базы
сохраняют выбранный режим; база без сохранённой настройки открывается как anonymous.
Для парной работы нужен okama-planner[reports]>=0.5.1,<0.6.0.