Optuna MCP Server

Установка

Работает в

• Claude Desktop
• Claude Code
• SourceCraft
• Koda
• Coddy

Ручная установка

{"mcpServers":{"Optuna":{"command":"/path/to/uvx","args":["optuna-mcp","--storage","sqlite:///optuna.db"]}}}

Что делает

Optuna MCP Server открывает клиенту MCP базовые операции библиотеки Optuna для подбора параметров. Модель создает исследование (`create_study`) с направлением minimize или maximize, выбирает сэмплер (`set_sampler`), просит набор параметров у Optuna (`ask`) по заданному пространству поиска и сообщает результат пробы (`tell`). Цикл повторяется, пока модель или человек не остановит его. Лучшую пробу и фронт Парето отдают `best_trial` и `best_trials`. Вторая группа — визуализация. Инструменты `plot_optimization_history`, `plot_contour`, `plot_parallel_coordinate`, `plot_slice`, `plot_param_importances`, `plot_pareto_front` и другие возвращают графики картинками, а `launch_optuna_dashboard` поднимает веб-панель Optuna на порту 58080. Значение целевой функции вычисляет сама модель или другой инструмент, например интерпретатор JavaScript. В примерах репозитория так подбирают параметры кодирования x264 в FFmpeg по SSIM, рецепт печенья и настройки Matplotlib. Результаты можно сохранять, передав в `--storage` адрес базы, например SQLite.

Для кого. Исследователям и инженерам, которые подбирают гиперпараметры моделей или параметры программ и хотят вести поиск диалогом в Claude Desktop или Claude Code.

Пример запроса к агенту

Создай исследование Optuna для минимизации суммы квадратов x и y, предложи параметры от -1 до 1 и нарисуй историю оптимизации

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

• Сервер рассчитан на Python 3.12 или 3.13 и запускается через `uvx` или Docker.
• Без `--storage` исследования живут в памяти процесса и пропадают после перезапуска клиента. Для сохранения укажите адрес базы, например `sqlite:///optuna.db`.
• Значение целевой функции сервер не считает: его присылает модель или другой инструмент через `tell`.
• `launch_optuna_dashboard` поднимает веб-панель на порту 58080, а в Docker для этого нужен `--net=host`.

Как отключить. Удалите запись `Optuna` из `claude_desktop_config.json` и перезапустите приложение, либо выполните `claude mcp remove optuna` в Claude Code. Файл базы, указанный в `--storage`, остается на диске.

Коротко о README

README коротко называет три сценария: автоматический подбор гиперпараметров моделью, разбор результатов Optuna в чате и оптимизация входа и выхода других MCP-инструментов. Дальше идут установка через `uv` и Docker, перечень инструментов по группам Study, Trial, Visualization и Dashboard и пять примеров с запросами и снимками экрана.