cc5-mcp-server
MCP server to control Reallusion Character Creator 5 (CC5, 5.2 supported) from LLMs like Claude via natural language
Install / Use
claude mcp add mackatwentytsuru -- npx -y github:mackatwentytsuru/cc5-mcp-serverIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of cc5-mcp-server
cc5-mcp-server scores 72/100 on our quality scale, 871st of 950 AI & Machine Learning skills we index.
Its MCP Server is 47 KB long, well organised into 59 sections with 14 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 10 days ago, so cc5-mcp-server is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-22. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
cc5-mcp-server compared with similar skills
All 4 of these similar skills score higher than cc5-mcp-server; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| cc5-mcp-server (this skill)by mackatwentytsuru | 72 | 10 | 10d ago | MCP Server |
| claude-memby thedotmack | 100 | 119.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.7k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install cc5-mcp-server?
- Run
claude mcp add mackatwentytsuru -- npx -y github:mackatwentytsuru/cc5-mcp-server. The install tabs above show the steps for each supported agent. - Which AI agents does cc5-mcp-server work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is cc5-mcp-server safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is cc5-mcp-server still maintained?
- The repository was last updated 10 days ago, so cc5-mcp-server is actively maintained.
Skill content
View source on GitHubCC5 MCP Server
An MCP (Model Context Protocol) server that lets LLMs like Claude control Reallusion Character Creator 5 through natural language. Adjust facial features, apply body presets, capture viewport screenshots, load assets, and export FBX files -- all via conversational commands.
Character Creator 5.2 is supported. The author uses this server every day on CC5.2, including the 5.2 Body Wrap steps (Generate Wrap Points, Align Points, Save / Load Wrap Points). CC5.2 に対応しています。作者は毎日 CC5.2 で使っています(5.2 の Body Wrap の手順を含む)。
Architecture
┌─────────────┐ stdio ┌──────────────────┐ HTTP :5101 ┌──────────────────┐ RLPy ┌─────┐
│ LLM Client │ ◄────────────► │ MCP Server │ ◄──────────────► │ CC5 Plugin │ ◄──────────► │ CC5 │
│ (Claude) │ │ (Node.js / TS) │ │ (Python / Qt) │ │ │
└─────────────┘ └──────────────────┘ └──────────────────┘ └─────┘
The MCP server communicates with Claude via stdio transport and forwards commands over HTTP to a Python plugin running inside CC5. The plugin executes all RLPy API calls on the main thread via a QTimer-driven command queue, ensuring thread safety.
Features
MCP Tools (100)
The MCP server provides 100 tools (registered in 23 modules under src/tools/) for controlling CC5. This list matches the code: there is one server.tool( call per tool in src/tools/*.ts (100 in total, all with unique names).
Scene & Avatar Management (8)
| Tool | Description |
|------|-------------|
| check_cc5_connection | Verify CC5 is running and the bridge plugin is active |
| list_avatars | List all avatars in the current scene |
| get_scene_objects | List all scene objects (avatars, props, lights, cameras) |
| get_avatar_info | Get avatar details including all non-zero morph values |
| create_avatar | Create a new neutral base avatar in the scene |
| delete_avatar | Delete an avatar by name, or all avatars |
| capture_viewport | Capture a screenshot of the CC5 3D viewport |
| set_subdivision_level | Set HD subdivision level (0 = base, 1 = medium, 2 = HD) |
Morph Controls & Character (7)
| Tool | Description |
|------|-------------|
| search_morphs | Search morph catalog by keyword |
| adjust_morph | Adjust a single morph slider (-1.0 to 1.0) |
| adjust_multiple_morphs | Batch-adjust multiple morph sliders at once |
| get_morph_value | Query the current value of a morph slider |
| reset_morphs | Reset all morphs to zero |
| apply_body_preset | Apply a body type preset (athletic, muscular, slim, heavy, average) |
| describe_character | Natural language description of current character appearance |
Facial Expressions & Profiles (5)
| Tool | Description |
|------|-------------|
| get_expression_info | Get available expression groups and sliders |
| set_expression | Set one or more expression sliders by name (weights 0.0-1.0) |
| reset_expression | Reset all expression sliders to neutral |
| get_facial_profile | Detect the current avatar's facial (expression) profile — authoritative RLPy profile type (CC5MetaHuman/CC4Extended/CC4Standard/Traditional), expression-set UID, per-category slider counts, and a heuristic ExPlus/HD/MetaHuman/Traditional class + ARKit capability. Read-only. |
| convert_facial_profile | Swap the active facial profile by loading a target .ccFacialProfile asset (RIFacialProfileComponent.LoadProfile). RLPy has no direct profile-type / one-click-ExPlus-upgrade API, so a pre-built target profile file is required. dry_run defaults to true (inspect + validate only). Intended as a temporary switch before export → convert back to a backup to restore. |
Content & Assets (9)
| Tool | Description |
|------|-------------|
| list_clothes | List clothing on the current avatar |
| list_hair | List hair on the current avatar |
| list_accessories | List accessories on the current avatar |
| remove_scene_item | Remove clothing, hair, or accessories by name |
| set_item_visible | Show or hide a scene item (clothing, hair, accessory, prop, light) |
| browse_content | Browse CC5 content folders (clothes, shoes, poses, motions, etc.) |
| load_asset | Load a CC5 asset file (.iAvatar, .ccm, .iClothes, etc.) |
| export_fbx | Export the current avatar as an FBX file. Mirrors the CC5 "Export FBX" dialog: target_tool preset, export_motion ("Mesh and Motion"), sub_d_level (HD subdivision), embed_textures, fps, motion_range, convert_image_format, texture_size. A bare filename exports into D:\CC5Export (override via CC5_EXPORT_DIR). |
| create_actor_mixer | Generate ActorMIXER PRO mixer assets (.ccMixerPreset) from the open avatar. confirm_create gates a dry-run (false, CANCELs) vs real creation (true). Requires the ActorMIXER PRO plugin. |
Materials & Shaders (9)
| Tool | Description |
|------|-------------|
| get_material_info | Get mesh and material names |
| get_diffuse_color | Get diffuse color of a material |
| set_diffuse_color | Set diffuse color (RGB, 0.0-1.0) |
| get_material_properties | Get opacity, glossiness, and specular values of a material |
| set_material_opacity | Set opacity (0.0 = transparent, 1.0 = opaque) |
| set_material_glossiness | Set glossiness (0.0 = matte, 1.0 = glossy) |
| set_material_specular | Set specular weight |
| get_shader_parameters | Get Digital Human Shader parameters of a material |
| set_shader_parameter | Set one Digital Human Shader parameter (skin roughness, SSS, micro-normal, ...) |
Colors (4)
| Tool | Description |
|------|-------------|
| set_eye_color | Set eye color (convenience shortcut) |
| set_hair_color | Set hair color (convenience shortcut) |
| set_lip_color | Set lip color (convenience shortcut) |
| set_skin_color | Set a uniform skin tone across all body skin materials |
Camera (3)
| Tool | Description |
|------|-------------|
| get_camera_info | Get camera position and focal length |
| set_camera_focal_length | Set camera focal length |
| frame_camera | Move the viewport camera to a preset view (face close-up, home, ...) |
| list_cameras | List cameras with position, focal length, angle of view and whether scripts can move them (the Preview Camera cannot) |
| dolly_camera | Move the viewport camera toward/away from the subject like the mouse wheel (15 cm per notch at the face view at first; the step size can change during a session, it became 42 cm once, so use capture_framed_crop to compare options at equal size), without moving the user's mouse |
| list_avatar_parts | List brows, eyelashes, beard, eyes, teeth and other avatar parts (HD brows are parts, not hairs) |
| remove_avatar_part | Remove brow or beard parts by name or type |
Lighting (9)
| Tool | Description |
|------|-------------|
| get_lights | List all lights in the scene |
| get_light_info | Get color and multiplier of a named light |
| set_light_color | Set light color (RGB) |
| set_light_multiplier | Set light intensity multiplier |
| set_light_active | Turn a light on or off |
| set_light_shadow | Toggle shadow casting and/or set shadow darkness |
| get_visual_settings | Get ambient color and IBL state |
| set_ambient | Set the scene ambient (fill) light color |
| set_ibl | Enable/disable image-based lighting, optionally loading an HDRI |
Edit & History (2)
| Tool | Description |
|------|-------------|
| undo | Undo the last operation |
| redo | Redo an undone operation |
Pop-up (dialog) detection
| Tool | Description |
|------|-------------|
| list_dialogs | List the dialogs currently open in CC5 and Reallusion Hub (title, body text, button labels, process, foreground) with a PNG of each when Windows can render it. Read-only; works even while CC5's main thread is blocked by a modal dialog. It never clicks. The only tool that presses a button by name is click_ui_button (below), and it refuses licence / purchase / delete / login buttons and presses nothing while such a window is open. |
Automatic warning (Japanese): while a dialog is open, every tool result starts with ⚠ CC5 に小窓が出ています ... (or ℹ Reallusion Hub に小窓 ...) showing title / body / buttons. Dialogs that look like agreements, purchases, logins, updates, deletes or overwrites are flagged "人が判断". Scans are cached ~4 s (about 1 s when a rescan is needed). Implemented by scripts/list-dialogs.ps1 (EnumWindows + UI Automation), independent of the bridge. Set CC5_DIALOG_WATCH=0 to disable, CC5_DIALOG_WATCH_IGNORE_HUB=1 to hide Hub-only notices.
UI automation: presets, SkinGen, windows, framed capture, one button (10) -- no mouse
See UI automation without the mouse for how it works and what it will and will not press.
| Tool | Description |
|------|-------------|
| apply_preset | Apply preset file(s) to the avatar with RFileIO.LoadFile: eyelash presets (.ccAvatarPreset), eyelash strips (.rlEyelashElement), SkinGen makeup (.ccSkinGenPreset), hair, cloth, ... (a fixed list of types; never a project, character or FBX). Answers only the known question windows (Apply Character Preset / Eyelash Elements, add-or-replace layer, exit SkinGen editing mode) and reports every other window with a screenshot. Reports what was added/removed in the scene |
| list_presets | List preset files that are on disk, by category (eyelash_preset, eyelash_element, makeup_lip, makeup_eye, makeup_eyelash, ...) or $/... content folder; names shows which wanted presets are missing (cloud items are not on disk) |
| skingen_state | Read the SkinGen editor: on/off, tab, layers (visible / HIDDEN, selected) and the selected layer's opacity |
| skingen_editor | Turn the SkinGen editor on/off; off bakes (~10 s), answers "exit SkinGen editing mode?" and waits until CC5 is quiet |
| skingen_layer | Select / show / hide / set opacity (0-100) / delete a SkinGen layer, by index or name; reads the result back. Delete needs confirm_delete=true; a confirmation window is never answered |
| list_cc5_windows | The pop-up / question windows CC5 has open right now, read inside CC5 with Qt: title, text, buttons, check boxes, progress or needs-a-person flags, plus a PNG of each (QWidget.grab). Read-only; works behind an ssh tunnel |
| get_ui_job | Look at or wait for a job the tools above started (use the job id from a "Still running" reply) |
| find_ui_widgets | Read-only finder for CC5's own Qt widgets by objectName / class / text, to discover names for new automation |
| capture_framed_crop | Frame a preset view, render it big (default 3600 px) and cut a fixed box, so options are compared at the same scale (does not depend on dolly_camera) |
| click_ui_button | Press ONE named button of a CC5 window, dialog or dock panel with Qt's click() (works while the Windows screen is locked), or one entry of its drop-down menu (menu_item). Refuses ambiguous, hidden or disabled buttons and every button about points (except Body Wrap's exact "Generate Wrap Points" and "Align Points" and the menu entries "Save Wrap Points" / "Load Wrap Points", the owner's exception of 2026-10-31), buying, deleting / removing, licences, activation, upgrades, credits, subscriptions or payment. Returns a picture of the window and the dialogs that are open; never answers a window it opened. See Pressing one named button |
MetaHuman (2)
| Tool | Description |
|------|-------------|
| bake_skin_textures | Open CC5's Skin Edit
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
119.0kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.7kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
