Kimodo MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HF_HOME | No | Optional shared Hugging Face cache and local authentication directory. | |
| KIMODO_REPO | Yes | Absolute path to the reviewed upstream checkout. | |
| KIMODO_PYTHON | Yes | Absolute path to Python with Kimodo and inference dependencies. | |
| KIMODO_DATA_DIR | Yes | Shared jobs, reports, exports, and registrations outside this repository. | |
| KIMODO_JOB_TIMEOUT | No | Waiting and execution limits, applied separately; default `3600` seconds. | 3600 |
| KIMODO_WORKER_MODE | No | `service` is the independent worker; optional `child` mode follows the client process tree. | |
| TEXT_ENCODER_DEVICE | No | `cpu` reduces GPU use by moving the encoder into system memory. | |
| KIMODO_CHARACTER_FBX | No | Optional source for the supported fitted-character profile. | |
| KIMODO_UNREAL_ENGINE | No | Optional Unreal installation root containing `Engine`. | |
| KIMODO_ALLOW_DOWNLOADS | No | `1` permits first-run downloads; ordinary worker startup is offline. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_capabilitiesA | Discover every registered operation, workflow, input schema, model and implementation boundary. |
| get_workflowA | Get an ordered workflow recipe, required inputs, completion evidence and recovery guidance; run nothing. |
| get_input_schemaB | Read a complete JSON input schema, including advanced generation and constraint controls. |
| list_modelsA | List exact supported model IDs, skeletons, export formats and upstream revision. |
| health_checkA | Check connection/storage; optionally probe the configured Python runtime without downloads. |
| get_workspace_stateB | Read shared worker/memory/editor status, character, saved Unreal target and recent job history. Editor reachability checks only local TCP listeners. This does not start services, load models, verify an open project, or claim that the configured machine has sufficient inference capacity. |
| get_unreal_targetB | Read the same locally saved Unreal project, skeleton, mesh and destination used by the studio. |
| save_unreal_targetB | Save explicit Unreal target fields for this workspace; this does not open a project or import assets. |
| list_job_outputsB | List verified native, skeleton and fitted-character files with checksums, paths and sample/attempt identity. |
| build_character_previewB | Prepare, execute and verify a registered character preview through the same workflow as the studio. Reuses a valid completed preview or chooses an unused attempt under a shared lock. Uncertain editor dispatch blocks automatic retries. Requires the supported registered source and Blender. |
| validate_motionB | Validate text segments, model compatibility, frame ranges and kinematic constraints offline. |
| generate_motionB | Queue motion generation and return a job ID immediately. May download weights if operator enabled it. |
| plan_animationA | Turn a natural action description and optional timed beats into an explicit generation plan. Choose draft, balanced or detailed effort. Defaults: four seconds, one candidate, seed zero, current SOMA model, native postprocessing, NPZ and standard-T-pose BVH. No generation is started. |
| generate_animationC | Generate from a plain-language brief with transparent presets; return a durable job immediately. |
| revise_animationA | Plan or submit a new version while preserving every setting not explicitly changed. The assistant supplies the rewritten action, not a vague editing instruction. Timing edits never silently retime existing constraints. The original job and outputs remain unchanged. |
| get_jobB | Get durable status, current stage, request, and final export manifest. |
| list_jobsB | List recent jobs shared by clients configured with the same data directory. |
| cancel_jobB | Request cancellation of a queued or running job; completed outputs remain available. |
| get_job_logB | Read a bounded tail of generation diagnostics with Hugging Face tokens redacted. |
| get_artifactA | Resolve and verify an exported file by its exact manifest path, including checksum and local URI. |
| inspect_motionB | Measure a completed NPZ: timing, skeleton, root travel, bounds and finite-value checks. |
| preview_motionC | Create an offline HTML animation viewer with playback, scrubber and camera controls. |
| export_motionA | Convert a completed native NPZ into SOMA BVH, SMPL-X AMASS, or G1 MuJoCo CSV without generation. Requires the configured Kimodo runtime; runs offline on CPU without model weights. Only the source model's formats are accepted. Changed options must apply to the selected format. The original job stays unchanged; matching verified exports are reused. An incomplete attempt blocks automatic retries. Pass the returned export_id to prepare_blender_handoff for derived BVH. |
| inspect_motion_framesA | Read selected source frames as exact joint positions, hierarchy, timing and optional rotation matrices. Uses checksum-verified completed motion, not rendered pixels or invented poses. Select up to 16 ordered frames and optionally named joints. Missing metadata remains explicitly unavailable. |
| extract_motion_constraintsA | Map several actual SOMA poses to destination frames as one reusable full-body or limb constraint. Both frame lists must be ordered, unique and equally sized. World root coordinates are retained. Add the returned constraint to a new request, then validate its duration and all constraint conflicts. This reads poses; it does not smooth, resample or splice clips or guarantee seamless transitions. |
| extract_pose_constraintB | Reuse an actual SOMA pose as a constraint for a new generation, preserving its world position. Returns a constraint to add to GenerateRequest.constraints. Validate the full new request; pose anchoring does not guarantee terminal-joint twists, velocity continuity or a seamless loop. |
| analyze_motion_qualityA | Measure speed, jerk, bone drift, contact sliding, floor proxies and endpoint seams. These are review diagnostics, not a realism score or automatic repair. Original motion is unchanged. |
| create_motion_reviewB | Create an offline three-view player, exact-frame contact sheet and numerical diagnostic file. Highlights uniform timeline samples and metric extrema with fixed whole-clip camera bounds. |
| compare_motionsA | Compare two completed motion samples with synchronized exact-frame views and measured differences. Requires matching FPS and skeletons. B frame = A frame + offset. Root-relative removes translation only. Differences do not rank realism or prompt adherence; inspect both candidates before choosing. |
| get_character_profileA | Inspect the operator-configured fitted-character profile without loading Blender. |
| prepare_character_handoffB | Prepare Blender rigging, skinning and motion retargeting for the configured character. Uses the inspected source's exact checksum. Saves a separate rigged mesh, animation FBX, .blend, and verification report. Execute the returned script through Blender MCP. |
| prepare_blender_handoffA | Prepare a trusted Blender script to import a generated SOMA BVH and save .blend/FBX. Omit export_id to use the original manifest BVH, or select the exact ID returned by export_motion to use a verified derived BVH. Use a new attempt when changing the source. No editor action runs. |
| execute_blender_handoffB | Run only the prepared fixed script in the connected local Blender and verify its exports. A completed receipt is reused. After an uncertain dispatch inspect the receipt before a new attempt. Character handoffs include an animated GLB for the local studio viewer. |
| get_handoff_reportC | Read the Blender execution report for a managed skeleton or fitted-character handoff. |
| prepare_unreal_handoffA | Prepare animation-only Unreal import after Blender reports a verified FBX export. The editor checks the exact project and matching rig hierarchy before creating an asset. Import the rigged character mesh first, then use execute_unreal_handoff. |
| execute_unreal_handoffA | Import a prepared animation into its exact open Unreal project and verify the saved asset. Requires the operator's engine registration and loopback Python remote execution. Executes only the bundled handoff script. A completed matching receipt is reused. |
| get_unreal_reportB | Read a managed Unreal import's final timing, rig and asset-path verification report. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| animation_workflow | Plan, validate, generate, inspect and export an animation from a creative brief. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Supported Kimodo models | Exact model identifiers, skeletons, native formats and reviewed upstream revision. |
| Generation request schema | Complete structured generation contract, including advanced controls and constraints. |
| Agent capability catalog | Live tool registry, workflows, schema index, limits, requirements and unsupported operations. |
| Local animation workspace | Shared runtime/worker readiness, character, saved Unreal target and recent jobs. |
TDQS
Scored across 37 tools
Most tools target distinct lifecycle stages, but several boundaries are subtle: generate_motion vs generate_animation, plan_animation vs revise_animation, and inspect_motion vs inspect_motion_frames vs analyze_motion_quality vs create_motion_review. Detailed descriptions help, but an agent could still misselect among these overlapping motion-generation and inspection tools.
Tool names consistently use snake_case and mostly follow a clear verb_noun pattern such as list_models, generate_motion, inspect_motion, prepare_blender_handoff, and execute_unreal_handoff. Minor exceptions like health_check are readable and do not disrupt the overall convention.
With 37 tools, the server is heavy for an agent-facing surface and exceeds the typical well-scoped range. The domain is complex, but multiple generation, inspection, review, export, and handoff variants make the set difficult to navigate as a whole.
The surface covers a broad lifecycle: planning, validation, generation, job management, inspection, export, review, comparison, character prep, and Blender/Unreal handoffs. Minor gaps exist around cleanup/deletion and broader character management, but core workflows are well covered.