Optuna MCP Server

Install

Works in

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

Manual install

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

What it does

Optuna MCP Server exposes the basic operations of the Optuna library for parameter search to an MCP client. A model creates a study (`create_study`) with a minimize or maximize direction, picks a sampler (`set_sampler`), asks Optuna for a parameter set (`ask`) within a given search space and reports a trial result (`tell`). The loop repeats until the model or a person stops it. `best_trial` and `best_trials` return the best trial and the Pareto front. The second group is visualization. `plot_optimization_history`, `plot_contour`, `plot_parallel_coordinate`, `plot_slice`, `plot_param_importances`, `plot_pareto_front` and others return charts as images, and `launch_optuna_dashboard` starts the Optuna web dashboard on port 58080. The objective value is computed by the model itself or another tool, such as a JavaScript interpreter. The repository examples tune x264 encoding options in FFmpeg by SSIM, a cookie recipe and Matplotlib settings. Results can be saved by passing a database URL, for example SQLite, to `--storage`.

Who it is for. Researchers and engineers who tune model hyperparameters or program settings and want to run the search as a dialogue in Claude Desktop or Claude Code.

Example request

Create an Optuna study that minimizes the sum of squares of x and y, suggest parameters from -1 to 1 and plot the optimization history

MCP

Transport

stdio

Authentication

not required

Limitations

• The server needs Python 3.12 or 3.13 and runs through `uvx` or Docker.
• Without `--storage` studies live in process memory and vanish when the client restarts. To persist them, pass a database URL such as `sqlite:///optuna.db`.
• The server does not compute the objective: the model or another tool sends it through `tell`.
• `launch_optuna_dashboard` starts a web dashboard on port 58080, and in Docker that route needs `--net=host`.

How to disable. Delete the `Optuna` entry from `claude_desktop_config.json` and restart the app, or run `claude mcp remove optuna` in Claude Code. The database file given in `--storage` stays on disk.

README in short

The README names three use cases: model-driven hyperparameter tuning, analyzing Optuna results by chat, and optimizing the input and output of other MCP tools. It then covers install with `uv` and Docker, a tool list grouped as Study, Trial, Visualization and Dashboard, and five examples with prompts and screenshots.