okama-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает библиотеку okama к ИИ-ассистентам для расчёта портфелей, симуляций Монте-Карло и построения границы эффективности без написания кода на Python.
claude mcp add okama-mcp -- uvx okama-mcpЧто делает okama-mcp
Сервер открывает ассистенту функции инвестиционной библиотеки okama и планировщика okama Planner. Модели могут находить активы через search_assets, прогонять бэктесты и прогнозировать пенсионные выплаты. Писать код для расчётов не требуется. ИИ сам обращается к нужным инструментам.
Внутри используется библиотека FastMCP с поддержкой двух транспортов: локального stdio и удалённого HTTP. Финансовые вызовы не сохраняют состояние, поэтому модель передаёт спецификацию активов целиком при каждом запросе. Чтобы избежать повторных долгих вычислений, сервер кэширует готовые объекты Portfolio и EfficientFrontier по хэшу содержимого. Поддерживаются вложенные портфели, когда отдельная корзина бумаг выступает активом внутри другой структуры.
Для работы нужен Python версии не ниже 3.11. Выгрузка отчётов в Excel и реестр клиентов требуют локального запуска через stdio: на публичном HTTP-эндпоинте эти функции недоступны.
Какие задачи решает
- рассчитать границу эффективности для набора активов
- смоделировать пенсионный план методом Монте-Карло с учётом инфляции
- провести бэктест инвестиционного портфеля на исторических данных
- найти активы и тикеры по названию или коду ISIN
Примеры запросов агенту
- Протестируй историческую доходность портфеля из 30% золота и 70% недвижимости за последние 15 лет.
- Построй границу эффективности для фондов SPY, BND и GLD при безрисковой ставке 3%.
- Сделай прогноз методом Монте-Карло для выхода на пенсию со снятием 1000 долларов в месяц на 25 лет.
Как установить okama-mcp
Командой платформы
claude mcp add okama-mcp -- uvx okama-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from okama-mcp <команда>
Командой платформы
codex mcp add okama-mcp -- uvx okama-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from okama-mcp <команда>
Файл настроек
{
"mcpServers": {
"okama-mcp": {
"command": "uvx",
"args": [
"okama-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from okama-mcp <команда>
Файл настроек
{
"servers": {
"okama-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"okama-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from okama-mcp <команда>
Командой платформы
gemini mcp add okama-mcp uvx okama-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from okama-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о okama-mcp
Как установить okama-mcp в Claude Code?
Выполните в терминале команду claude mcp add okama-mcp -- uvx okama-mcp.
Что делает MCP-сервер okama-mcp?
Он предоставляет языковой модели доступ к финансовой библиотеке okama. Ассистент строит графики границы Марковица, проводит симуляции Монте-Карло и рассчитывает доходность портфелей.
Чем отличаются режимы stdio и HTTP?
Локальный режим stdio поддерживает экспорт таблиц в Excel и работу с локальным реестром клиентов. Сетевой запуск через HTTP ограничивается портфельной аналитикой и расчётами планов.
