LPC Character Generator

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/kyuza1-lpc-character-mcp

About

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

5 read · 3 write · 1 delete · 2 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (11)

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

• clear_cache

  Deletes cached images (they are downloaded again when needed). older_than_days: only delete images unused for more than N days (0 = all). dry_run: only report how much would be freed, without deleting.

• from_site_url

  Reads a link from the LPC generator site (e.g. ...Character-Generator/#sex=male&body=Body_Color_light&...) and returns {body_type, items} ready for generate_character (old links work too). Also accepts the JSON from the site's "Export to Clipboard (JSON)" button. Unrecognized parameters are listed in `unresolved`.

• generate_batch

  Generates many random characters at once (e.g. villagers for a town). Saves <prefix>_01.png, <prefix>_02.png... and the credits for each. body_types: bodies to pick from (default: male and female). fixed_items: items everyone gets (e.g. [{"id": "tools/tool_hammer"}]).

• generate_character

  Builds the character spritesheet and saves it as PNG. Every result has `animation_check`: whether every item has every animation and, if not, what is missing plus complete alternatives. TELL the user when complete=false. prefer_complete=True swaps incomplete items for the closest item with every animation (keeping the color when possible) and lists the swaps in `replaced`. Only use it with the user's consent: it changes the look (e.g. apron becomes overalls). output_dir: folder to save into (e.g. the game project's sprites folder). Inside a Godot project the .tres gets the right res://…

• get_item

  Item details: supported bodies, animations with art per body, missing animations and complete alternatives, colors or variants, multi-color parts and oversized animations.

• list_categories

  Lists item categories (e.g. body, hair, torso/shirts) with how many items each has.

• preview_character

  Shows the character in the chat without saving files: the 4 directions side by side. animated=True (default) returns an animated GIF of the animation; False, a still image. animation: walk, idle, slash, run..., 1h_slash, watering, or an oversized one (tool_hammer, slash_128...). Use it to check the look before generate_character.

• random_character

  Rolls a random character (skin, head, hair, clothes, shoes and sometimes a beard, hat or vest), using only items that have every animation. Does not render: returns {items, body_type, url} to review and pass to generate_character. `fixed_items` are always added (e.g. a weapon). Use `seed` to repeat the same roll. `licenses` limits the roll to those license families (e.g. ["CC0", "OGA-BY"]).

• search_items

  Searches items. All filters are optional and combine: query: words in the name/id (all must match), e.g. "leather armour". category: id prefix, e.g. 'hair', 'torso/shirts', 'weapons/sword'. body_type: only items that exist for this body (male, female, teen...). animation: only items with art for this animation (idle, walk, slash...) for body_type (or male if body_type is not given). type_name: item type (hair, clothes, legs, shoes, weapon, hat...). complete_only: only items with every animation. Otherwise complete items come first. licenses: only items whose every art part is availa…

• to_site_url

  Builds a generator site link with these items, to open and tweak the character in a browser.

• update_definitions

  Pulls new items and palettes from the official LPC generator repository. clear_image_cache=True also deletes downloaded PNGs so they are fetched again.

Signals

Stars

1

Forks

0

Open issues

0

Weekly downloads

63

Last commit

Sep 28, 2026 (1 month ago)

Last release

Sep 28, 2026 (1 month ago)

Last package publish

Sep 28, 2026 (1 month ago)

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

Details

Registry name

io.github.kyuza1/lpc-character-mcp

Version

0.5.0

Auth

No auth

Packages

pypi lpc-character-mcp

License

MIT

Repository

github.com/kyuza1/lpc-character-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql