Pose Lab

Measured spatial answers for posing first-person arms and a rifle in Blender

Connector by hpdkhoa · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 1

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/hpdkhoa-poselab-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Measured spatial answers for posing first-person arms and a rifle in Blender

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 7 read · 8 write · 0 delete · 20 not yet classified
Secrets: None asked for
Install scripts: None found
Runs as: Python package

Tools by what they do 35

Read from the source code; the running server may list different tools.

Read 7 · Look things up without changing anything.

check_set
describe
list_rigs
scan_clip
solve
solve_grip
view_cover

Write 8 · Create, change, send or run things.

load_clip
move_gun
move_part
reach
record_clip
save_clip
shift_hand
submit

Not yet classified 20 · We could not tell from the name and description.

anatomy
arm_ranges
body_size
clearance
distance
faces_eye
fix_clip
grip
human_sizes
load_rig
pose_clip
pose_idle

Show 8 more tools

purpose
render
retarget_clip
screen
snapshot
turn_bone
visible
where

Secrets and settings it asks for

Other settings (environment variables or headers).

POSELAB_BLENDER
POSELAB_OUT
POSELAB_RIGS

Network hosts it talks to 4

archive.cdc.gov · found in code
eatonhand.com · found in code
github.com · found in code
openlab.psu.edu · found in code

Files it touches

Your home directory (~)
Any path the agent passes to its tools

Tools (35)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

anatomy
Each arm against the human arm's limits. Rules: the elbow stays at least 2 cm below the shoulder while the hand works the gun; the elbow is a hinge bent 5 to 150 degrees; the wrist stays within 30 degrees of the forearm's line and inside its joint range (flexion 80, extension 70, radial 20, ulnar 30: the AAOS normal values); the hand's roll belongs to the forearm, not the wrist joint: the forearm turns at most 80 degrees each way from thumb up (pronation and supination, forearm_rotation_deg), and on a rig with forearm twist bones no link along the forearm rolls more than 50 degrees (forearm_li…
arm_ranges
The research behind anatomy's limits: for each joint of the arm (shoulder, elbow, forearm, wrist, finger knuckle, middle and end joints, thumb), the AAOS normal range (the 1965 table; tables_differ shows where other tables disagree), the range daily tasks use (Morrey 1981, Palmer 1985, Ryu 1991, Bain 2015), the value anatomy checks, and why it differs from the standard where it does. Full citations included. Needs no rig.
body_size
The loaded arms against human sizes: no bone and no part of the skin may be of a size no adult has. Measures the upper arm and forearm joint to joint, the hand's length (wrist joint to the middle finger's farthest skin), the skin's breadth and girth at the knuckles, the wrist's and the forearm's girth, and lists every one outside the 1st to 99th percentile of the sex (ANSUR II; human_sizes gives the ranges and allowances). Also skin_vs_capsules: how far the drawn skin lies outside the capsules clearance tests with; past 0.3 cm the checks pass poses whose picture clips. Run it before posing a n…
check_set
Every check on a clip in one summary for a gate: the worst clearance and when, the frames that break an arm or finger rule, the frames a hand in hold_sides is not holding, and each frame's numbers.
clearance
How deep the rifle sits inside the arms (capsules: forearm 3 cm, palm 1.8 cm, finger segments 0.75 cm). worst_cm 0 means nothing touches. The deepest contacts by segment, with the rifle point in the frame.
describe
What is loaded and the conventions every tool uses.
distance
The distance between two points, cm, and b minus a in the frame.
faces_eye
How squarely a surface faces the eye: facing 1 square on, 0 edge on, below 0 turned away.
fix_clip
Mends a clip against the checks and stores a new clip (out, default <clip>_fixed): pops are blended again from the good frames round them; a hold puts the hand back on its grip; a contact moves the wrist until the point touches its mark; clearance swings each elbow about its shoulder-wrist line (the wrist kept) by the least angle that clears, spread over neighbouring frames; anatomy swings the elbow the same way until it sits under the shoulder inside its bend, then turns the wrist back inside its limits and each finger joint back inside its range. Reports the scan before and after.
grip
How each hand touches the rifle: with the palm or with the back. A hand holds with its palm and the palm sides of its fingers. The back of the hand toward the rifle, or the rifle inside the back of the hand or of a finger, is a physical error; clearance with palms and fingers ignored never shows it. For each hand: touching (some part within hold_within_cm), holding (touching, the palm facing the rifle and its surface within palm_within_cm: palm_gap_cm; a fingertip on the rifle with the palm off it is not holding), palm_faces_rifle (1 square on, below 0 the back of the hand toward it), palm_con…
human_sizes
The research behind body_size's rules: the arm's and hand's sizes for men and women from ANSUR II (the 2012 U.S. Army anthropometric survey, 4,082 men and 1,986 women): mean, SD and the 1st to 99th percentiles of the upper arm, forearm, hand length and breadth, hand, wrist and forearm girth; what a rig is measured between, the landmark allowance where a rig's joint centres differ from the survey's skin landmarks, and why. Needs no rig.
list_rigs
The rigs to load: the built-in sample and those in the rigs file (POSELAB_RIGS).
load_clip
Adds a clip from a file: .pose.json bone data, an FBX animation, or a BVH (for example a text-to-motion model's output). A relative path is taken from the rigs file's folder. Reports how well its skeleton fits.
load_rig
Loads a rig: the arms on their idle pose, the rifle on the gun bone, its clips. Returns the frames, sign rules, named points, clips and moving parts. Call first.
move_gun
Moves the rifle from where it stands: roll + turns its right side up (about the bore); swing + takes the muzzle left, pitch + the muzzle up (about the pivot); right, forward, up move it in the view, cm. The hands in keep_hands keep their hold. Returns how far each hand ended from its hold and the barrel's angle off the view line.

Show 20 more tools

move_part
Draws a moving part of the rifle (such as carrier) back along the barrel, cm from home.
pose_clip
The arms as a clip has them at a time in seconds. The rifle follows the gun bone; its parts stay where move_part left them.
pose_idle
The arms back on the idle pose, every rifle part home.
purpose
Whether each hand does something: every hand in an action holds, pulls, presses or rests on a part, or reaches toward one, and a hand with no target breaks a rule. The part is the rifle's surface within target_cm of the point. A target may give "within_cm" (the part's size around the point); a rig point on a moving part rides with it. hold: the thumb and a finger pinch that part (grip's grasp rule kept to the part), or the hand wraps it (the palm within palm_within_cm of it and two fingers hooked on it: a power grip). pull: a pinch, or a finger hooked on it (its middle and end joints curled at…
reach
Puts a wrist on a point by arm IK; the hand keeps its turn. Returns how far the wrist ended from the point. Trying poles while the wrist stays put moves only the elbow: a way to clear a forearm.
record_clip
Builds a clip from poses you set: start (a name), key (the current pose at a time in seconds), stop (bakes the frames, each bone eased from key to key). Between keys the bones blend by rotation, so hands can drift off the rifle between keys.
render
Renders the pose as one labelled contact sheet: eye is the player's camera (90 degrees, 5 cm near plane); right, left, top and front look at the rifle from outside. Every tile is a Blender view, labelled so.
retarget_clip
Plays another rig's clip on this rig with one hand held on this gun's own hold (its rest hold, or mark) by arm IK, fingers mended: shared motion, the gun's own grip. keep_from_s..keep_to_s: a span the hand leaves the gun (a reload), kept as the clip has it. Stores the result as out (default <clip>_retarget).
save_clip
Writes a clip to the output folder's clips/: pose.json bone data, and fbx for a game engine.
scan_clip
Plays a clip frame by frame and runs each check. Reports for each check whether it passed, the worst value and when, and the time spans where it fails.
screen
Where a point falls on a 90 degree, 16:9 screen from the eye: x and y from -1 to 1, and whether it is on screen.
shift_hand
Moves one hand frame by frame by the given deltas (gun frame, cm): a hand that holds a part whose track changed follows the part's new path. The hand keeps its turn against the gun, its elbow its direction, its fingers their curl; the wrist and fingers are mended.
snapshot
Saves or loads a named pose (the arms and the rifle's parts).
solve
Searches rifle moves from the current pose for one meeting every goal, and leaves the scene there. Reports each goal at the best move and how often it was met across samples: a goal never met is a fact of the geometry.
solve_grip
Searches a hand's hold on the rifle: the palm on mark (moved along the barrel), the elbow toward each pole. A hold counts when the palm holds the rifle (grip), nothing clips past clearance_max_cm (ignore: declared contacts), every arm and finger rule holds, and the view stays within view_budget. The nearest hold to the mark that counts wins and the rig is left in it; the table shows what failed where.
submit
Ends the task. Call it once, when the scene is in its final state (or with your answer for a question).
turn_bone
Turns one bone by degrees about an axis through its head; the bones below it follow and nothing else moves. Use it to bend or straighten a finger joint, turn a wrist, or turn a whole arm at the shoulder. bone: a bone's name (an unknown name lists them all). The two signs of degrees turn opposite ways. The rifle does not move: use move_gun.
view_cover
The share of the player's view the arms cover (all, its lower left third, its bottom middle third): the arms rendered alone from the eye as a mask. A forearm or sleeve that fills the lower left hides the gun and the world.
visible
The share of a small disc round a point that the eye sees with nothing (arms, rifle) in the way.
where
Where bones, fingertips (<finger>_tip_<l|r>) and rig points are, in a frame.

Signals

Stars: 1
Forks: 0
Open issues: 0
Weekly downloads: 114
Last commit: Oct 24, 2026 (5 days ago)
Last release: Oct 14, 2026 (15 days ago)
Last package publish: Oct 14, 2026 (15 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.hpdkhoa/poselab-mcp
Version: 0.7.0
Auth: No auth
Packages: pypi poselab-mcp
License: MIT
Repository: github.com/hpdkhoa/poselab-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

More from hpdkhoa

Cite this page

Pose Lab MCP server. Agent Mart. https://agentmart.dev/connectors/hpdkhoa-poselab-mcp (last updated 2026-10-24)