How do I install Framesmith?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Framesmith need an API key?

No required environment variable is listed on this record.

What transport does Framesmith use?

Framesmith runs locally over stdio.

When was Framesmith last checked?

Last checked 2026-10-28. Engine-agnostic fighting game character authoring tool: JSON-on-disk project format, frame/state editing, export adapters, plus an MCP server (SvelteKit + Tauri + Rust).

Framesmith MCP 伺服器

接入你的智能体

新增此伺服器

Install from the publisher. Not a PlugMCP endpoint.

在 PlugMCP 上執行

用我們的金鑰與日誌託管一份副本。

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

在 PlugMCP 上執行

用我們的金鑰與日誌託管一份副本。

这是你新建的服务器，不是此条目的官方端点。若要用发布方的 URL 与凭证，请使用上方安装面板。

啟動

Server facts

Local

Transport: stdio
Last checked: 2026-10-28

Stars: 2
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Framesmith

Framesmith is an engine-agnostic fighting game character authoring tool. It manages portable character data on disk (JSON) and exports runtime-specific formats.

Core capabilities

Frame-data table with filtering and sorting
State editor with sprite and GLTF preview
Cancel graph view for route visualization
Rules system for defaults and validation
Export adapters (json-blob, zx-fspack)
MCP server for scripted and LLM-assisted workflows

Framesmith project format

A Framesmith project is a directory with this shape:

my-game/
  framesmith.rules.json
  characters/
    test_char/
      character.json
      cancel_table.json
      states/
        5L.json
        236P.json
      rules.json          # Optional per-character overrides

This repository root is also a valid project because it includes framesmith.rules.json and characters/.

Quick start

npm install
npm run tauri dev

Common commands

# Frontend + app shell
npm run dev
npm run tauri dev
npm run tauri build

# TypeScript checks/tests
npm run check
npm run test:run

# Runtime WASM package
npm run wasm:build
npm run wasm:build:dev

# Rust backend checks/tests
cd src-tauri
cargo test
cargo clippy --all-targets

MCP server

cd src-tauri
cargo run --bin mcp -- --characters-dir ../characters

See docs/mcp-server.md for tools, resources, and integration details.

CLI export

cd src-tauri
cargo run --bin framesmith -- export --project .. --all --out-dir ../exports

See docs/cli.md for full CLI reference.

Documentation map

docs/README.md: documentation index and routing guide
docs/data-formats.md: on-disk JSON schema and layout
docs/rules-spec.md: rules semantics and validation behavior
docs/zx-fspack.md: binary pack format reference
docs/runtime-guide.md: runtime integration guide
docs/runtime-api.md: runtime API details
docs/mcp-server.md: MCP server setup and tool list
docs/global-states.md: global state authoring and behavior
docs/character-authoring-guide.md: practical authoring workflow
AGENTS.md: contributor and code-map reference
CLAUDE.md: repo constraints and invariants

Repo map

framesmith/
  src/              # SvelteKit UI
  src-tauri/        # Rust app backend, MCP server, CLI
  crates/           # Runtime and FSPK library crates
  characters/       # Local project data samples
  docs/             # Design and reference docs