Repository navigation
vroid-studio-mcp v1.1.0
MCP server for VRoid Studio 2.14.0: lets AI agents create and edit characters in the real editor —
choose presets, tune sliders and colors, frame the camera, and save. It drives the editor's own
internal API through a BepInEx/IL2CPP plugin, so it does not use mouse or OCR automation and
keeps working while the window is minimized.
Changelog
- Custom presets in the normal preset list — saved Custom-tab items are now listed, previewed and
applied together with the stock presets, and an agent can create a new named custom preset in one call. - Custom item import/export — import and export reusable
*.vroidcustomitemfiles for Hairstyle
and Outfit. Import can add an item to the library or wear it immediately; export works for the item
currently worn and for items that are only stored. - Applied preset is reported —
presetsnow shows which preset or custom item is currently applied. - Safer batch calls — batch operations accept named arguments only and are validated before they run,
so an unknown or missing argument cannot silently hit the wrong parameter. - Clearer argument errors — invalid numbers, ranges and boolean values now return a precise error
instead of being silently ignored or replaced by a default. - More stable long sessions — fixed a memory leak that could grow the app during repeated editing,
and added diagnostics for troubleshooting. - Diagnostics are opt-in — diagnostic file dumps are off by default (
dump_artifactsenables them);
dialog tracing has its owndialog_traceswitch.
Install
- Install BepInEx 6 (Unity.IL2CPP, Windows x64), build
6.0.0-be.788into your VRoid Studio
folder, then launch the game once so BepInEx finishes setting itself up:
https://builds.bepinex.dev/projects/bepinex_be/788/BepInEx-Unity.IL2CPP-win-x64-6.0.0-be.788%2B5b766a3.zip - Copy from this archive into the VRoid Studio folder:
BepInEx/plugins/VroidStudioMcp.dllBepInEx/config/BepInEx.cfg(optional; keeps BepInEx logging off)
- Copy the data folders to the VRoid Studio folder (next to
VRoidStudio.exe):i18n/— corrected English labelslabels/— readable preset names
- Launch VRoid Studio. The MCP endpoint is then at
http://127.0.0.1:17891/mcp.
See README.md (English) or
README.ru.md (Russian) for details.
Archive contents
BepInEx/plugins/VroidStudioMcp.dll— the pluginBepInEx/config/BepInEx.cfg— BepInEx config with console/disk logging disabledi18n/en.json— corrected English label overlaylabels/10-*.json— preset label overlayREADME.md,README.ru.md,LICENSE
Notes
- VRoid Studio and BepInEx are not bundled — install them separately.
- Requires VRoid Studio 2.14.0 on Windows (or run through Wine).
- The DLL is built locally, not by CI; the archive's SHA-256 is attached for verification.
- License: MIT. VRoid Studio is a product of pixiv Inc.; this project is unaffiliated with pixiv.