Skip to main content
Glama
game-art-mcp

game-art-mcp

by Cuvara

game-art-mcp

面向 2D RPG 游戏美术方向的 AI 驱动像素艺术风格系统与 MCP 服务器。

目的

本仓库是项目美术方向的唯一事实来源。任何 AI 代理都可以进入此仓库,通过 MCP 查询项目上下文,并准确理解"我们的美术风格"意味着什么——无需依赖对话历史。

Related MCP server: Aseprite MCP Server

架构

game-art-mcp/
├── project.yaml              # Project config: which style is active
├── style/                    # Version-controlled style definitions
│   └── fantasy_pixel_v1/     # Style v1 (YAML rules + style bible)
├── registry/                 # Asset registry storage
│   ├── assets/               # One YAML file per registered asset
│   └── registry.yaml         # Auto-generated index of all assets
├── memory/                   # Art Memory storage (Phase 3)
│   ├── anchors/              # Style anchor YAML files
│   ├── references/           # Approved reference YAML files
│   ├── rejections/           # Rejection records
│   ├── decisions/            # Art decision records (ADR format)
│   ├── history.yaml          # Style version evolution log
│   └── memory.yaml           # Auto-generated memory index
├── src/
│   ├── style/                # Models, loader, validator
│   ├── assets/               # Asset registry (models + service)
│   │   ├── models/           # Zod schemas + TypeScript types
│   │   └── registry/         # AssetRegistry service (CRUD + query)
│   ├── memory/               # Art Memory (models, service, resolver)
│   │   ├── models/           # Zod schemas for anchors, references, rejections, decisions
│   │   ├── service/          # ArtMemoryService (CRUD + index)
│   │   └── resolver/         # ReferenceResolver (deterministic lookup)
│   ├── qa/                   # Art QA engine (Phase 4)
│   │   ├── models/           # QA types, report schema, rule interface
│   │   ├── rules/            # 13 deterministic rules (7 categories)
│   │   ├── runner/           # QARunner orchestrator
│   │   └── history/          # QA history persistence
│   ├── providers/            # Provider Adapters (Phase 5)
│   │   ├── models/           # ProviderAdapter interface, types, error codes
│   │   ├── adapters/         # Adapter implementations (mock-provider)
│   │   ├── registry/         # ProviderRegistry (adapter lookup + capabilities)
│   │   ├── gateway/          # ProviderGateway (dispatch + artifact storage)
│   │   └── artifacts/        # ArtifactStore (immutable provenance)
│   ├── production/           # Production Orchestrator (Phase 6)
│   │   ├── models/           # Types, state machine, error codes
│   │   ├── orchestrator/     # ProductionOrchestrator (coordinator)
│   │   └── store/            # ProductionStore (YAML manifest persistence)
│   ├── versioning/           # Versioning & Approval (Phase 7)
│   │   ├── models/           # Types, lifecycle states, error codes
│   │   └── services/         # VersioningService (approval, versioning, promotion, audit)
│   ├── context/              # ArtContextService
│   └── mcp/                  # MCP server + tools
│       └── tools/            # art-tools.ts, asset-tools.ts, memory-tools.ts, qa-tools.ts, provider-tools.ts, production-tools.ts, versioning-tools.ts
├── tests/                    # Unit + integration tests
└── docs/                     # Architecture, style system, phases

快速开始

npm install
npm run build
npm test

运行 MCP 服务器

npm start
# or with custom root:
ART_MCP_ROOT=/path/to/project npm start

验证风格

npm run validate

MCP 工具

风格工具(只读)

工具

描述

art.get_project_context

完整美术上下文(项目 + 风格 + 所有规则)

art.get_style

当前生效的风格定义

art.get_style_rules

特定规则类别(pixel_language、outline 等)

art.get_palette

带语义角色的调色板

art.validate_style

验证风格配置

资产工具(读 + 写)

工具

描述

art.asset.get

按 ID 获取资产

art.asset.find

搜索/筛选资产(类型、类别、状态、标签)

art.asset.exists

检查资产 ID 是否已注册

art.asset.register

注册新资产并执行完整验证

art.asset.update

更新现有资产(部分补丁)

art.asset.deprecate

将资产标记为已弃用

art.asset.archive

归档资产

art.asset.rebuild_index

从资产文件重建注册表索引

记忆工具(读 + 写)

工具

描述

art.memory.get_summary

记忆概览:锚点、决策、拒绝记录、引用计数

art.memory.explain_style

完整风格说明,包含规则、锚点、决策、规避项

art.memory.resolve_references

针对给定上下文的确定性引用查找

art.memory.get_anchor

按 ID 获取风格锚点

art.memory.find_anchors

搜索锚点(类别、状态、维度筛选)

art.memory.add_anchor

添加新的风格锚点

art.memory.get_reference

按 ID 获取已批准的引用

art.memory.find_references

搜索引用(角色、状态、asset_id 筛选)

art.memory.add_reference

添加新的已批准引用

art.memory.get_rejection

按 ID 获取拒绝记录

art.memory.find_rejections

搜索拒绝记录(类型、状态、原因筛选)

art.memory.add_rejection

添加新的拒绝记录

art.memory.get_decision

按 ID 获取美术决策

art.memory.find_decisions

搜索决策(状态筛选)

art.memory.add_decision

添加新的美术决策

art.memory.get_style_history

获取完整风格演进历史

QA 工具(只读)

工具

描述

art.qa.asset

对单个资产运行 QA 检查(完整报告)

art.qa.batch

对多个资产运行 QA 检查(批量报告)

art.qa.gate

QA 门禁检查——用于审批流程的通过/失败判定

art.qa.list_rules

列出所有可用 QA 规则及其定义

art.qa.rule

按 ID 获取特定 QA 规则的完整定义

art.qa.explain_failure

解释某条规则为何对某资产失败

art.qa.history

获取 QA 运行历史,可按资产 ID 筛选

提供商工具(读 + 写)

工具

描述

art.provider.list

列出所有已注册提供商及其元数据

art.provider.get

获取特定提供商的详细元数据

art.provider.capabilities

获取提供商能力(操作、格式、限制)

art.provider.health

检查提供商健康状态

art.provider.execute

通过提供商执行美术生成操作

art.provider.cancel

取消正在运行的提供商操作

art.provider.operation

按 ID 获取操作状态

art.provider.artifact

按 ID 获取工件详情和来源信息

生产工具(读 + 写)

工具

描述

art.production.plan

创建生产计划(执行前预览)

art.production.create

创建生产任务(计划 + 持久化,不启动执行)

art.production.start

开始执行生产任务

art.production.status

获取当前任务状态(摘要)

art.production.inspect

获取完整任务详情(事件、尝试、计划)

art.production.resume

恢复失败的任务

art.production.cancel

取消正在运行的任务

art.production.attempts

获取任务的尝试历史

art.production.approve

批准等待审批的任务

art.production.list

列出所有生产任务 ID

版本管理工具(读 + 写)

工具

描述

art.asset.current

获取资产的规范(当前)版本

art.asset.inspect_version

获取特定资产版本的详情

art.asset.history

获取资产的完整版本历史

art.asset.compare

比较同一资产的两个版本

art.asset.provenance

获取版本来源信息,包括审批记录

art.asset.approval.request

为候选资产请求审批

art.asset.approval.inspect

按 ID 获取审批记录

art.asset.approve

批准候选资产

art.asset.reject

拒绝候选资产

art.asset.request_changes

对候选资产提出修改要求

art.asset.promote

将已批准的候选版本提升为规范版本

art.asset.rollback

将规范版本回滚到先前版本

art.asset.archive_version

归档规范资产

风格和 QA 工具为只读。资产、记忆、提供商、生产和版本管理工具同时支持读取和写入。

资产注册表

资产注册表(第二阶段)以结构化元数据跟踪项目中的每个美术资产。资产以独立 YAML 文件存储在 registry/assets/ 中,并在 registry/registry.yaml 中建立索引。

主要特性:

  • 语义 ID — 点分隔的小写形式(例如 character.goblin.001)

  • 风格关联 — 每个资产都引用一个风格 ID + 版本

  • 关系 — variant_of、derived_from、animation_of 等

  • 状态跟踪 — 草稿、已批准、已拒绝、已弃用、已归档

  • 完整验证 — 模式、风格引用、源文件存在性、关系

完整文档请参阅 docs/ASSET-REGISTRY.md,元数据模式请参阅 docs/ASSET-METADATA.md。

美术记忆

美术记忆系统(第三阶段)为仓库提供持久的视觉知识。它记住什么被批准、什么被拒绝以及原因——这样代理无需对话历史就能理解项目的美术方向。

核心概念:

  • 风格锚点 — 定义风格的规范视觉示例(参见 docs/STYLE-ANCHORS.md)

  • 已批准引用 — 具有角色和维度的可信资产

  • 拒绝记录 — 什么不符合风格,使用受控的原因词汇表

  • 美术决策 — 采用 ADR 格式记录的视觉方向选择(参见 docs/ART-DECISIONS.md)

  • 引用解析器 — 确定性查找,为任何创作任务返回相关上下文

完整文档请参阅 docs/ART-MEMORY.md。

美术 QA

美术 QA 系统(第四阶段)为像素艺术资产提供确定性、可复现的质量门禁。每项检查都基于规则,包含期望值/实际值和结构化修复建议——不使用 AI 视觉、不使用嵌入、不自动修复。

核心概念:

  • 13 条规则,覆盖 7 个类别(技术、尺寸、调色板、透明度、像素、风格、记忆)

  • 3 种配置 — 严格(警告即失败)、默认(错误即失败)、宽松(仅严重问题失败)

  • 机器可读报告 — JSON 格式,包含每条规则的结果、严重级别、修复建议

  • 风格集成 — 从当前风格读取画布尺寸、调色板限制、像素规则

  • 记忆集成 — 检查被拒绝的方向和已接受的美术决策

  • QA 门禁 — 用于 CI 和审批流程的通过/失败判定

  • QA 历史 — 每个资产所有运行记录的持久日志

完整文档请参阅 docs/ART-QA.md。

提供商适配器

提供商适配器系统(第五阶段)为外部美术生成工具添加与提供商无关的接口。请求通过一个网关流转,该网关验证操作、委托给已注册的适配器,并以不可变来源信息存储生成的工件。

核心概念:

  • ProviderAdapter 接口 — 元数据、能力、健康状态、执行、取消

  • 工件 — 具有不可变来源信息的原始提供商输出(尚不是资产)

  • 能力 — 每个操作的详细信息(格式、最大分辨率)

  • 试运行 — 验证请求而不生成输出

  • 模拟提供商 — 内置测试适配器,支持失败/超时模式

  • 无自动选择 — 代理必须显式选择提供商

完整文档请参阅 docs/PROVIDERS.md。

生产编排器

生产编排器(第六阶段)协调完整的美术资产生成生命周期:请求验证、风格/引用/提供商解析、执行、QA、重试和审批门禁。

核心概念:

  • 协调者,而非事实来源 — 委托给样式系统、QA、提供方和注册表

  • 状态机 — 9 种状态,带经过验证的转换(从 created 到 completed/failed/cancelled)

  • 11 个生产阶段 — 从 REQUEST_VALIDATION 到 APPROVAL_GATE

  • 有界重试 — 可配置的 max_attempts(默认 3),QA 失败时提供修复计划

  • 审批边界 — 在 awaiting_approval 处停止,绝不自动批准

  • 计划过期检测 — 在执行前检测样式版本漂移

  • YAML 持久化 — 每个任务在 production/<job_id>/ 下有一个 manifest.yaml

  • 事件历史 — 每个任务所有状态变更的仅追加日志

完整文档请参阅 docs/PRODUCTION.md。

版本控制与审批

版本控制与审批系统(阶段 7)新增了不可变资产版本控制、显式审批工作流和完整审计追踪。任何版本都不会被删除;任何资产都不会被自动批准。

关键概念:

  • 资产生命周期 — 8 种状态:draft、pending_approval、approved、rejected、changes_requested、promoted、superseded、archived

  • 审批工作流 — request、approve、reject、request_changes,带结构化反馈

  • 审批策略 — 可配置:requires_qa_pass、allow_agent_approval、requires_human

  • 不可变版本 — 单调递增、父版本追踪、每个版本的完整溯源信息

  • 规范指针 — 跟踪当前版本;在提升/回滚时更新

  • 提升 — 带 QA 门禁和审批门禁的 compare-and-swap(比较并交换)

  • 回滚 — 将规范指针重新指向先前版本,绝不删除历史

  • 审计日志 — 9 种事件类型,仅追加,不可变

  • 操作者身份 — 每条记录都会跟踪 human、agent、system、provider

完整文档请参阅 docs/VERSIONING.md。

当前阶段

阶段 7 — 版本控制与审批(已完成)

完整路线图请参阅 docs/PHASES.md。

样式系统

样式是结构化的 YAML 文件,代表机器可读的美术方向:

  • style.yaml — 标识、画布尺寸、缩放

  • palette.yaml — 带语义角色的颜色

  • pixel-rules.yaml — 像素画约束

  • outline.yaml — 描边规则

  • shape-language.yaml — 视觉语言

  • lighting.yaml — 光照方向与规则

  • animation.yaml — 帧数、FPS、约束

详细信息请参阅 docs/STYLE-SYSTEM.md。

Available Tools

126 tools
art.aseprite.exportB

Export a canvas session to Aseprite format. Saves the canvas as PNG and generates the Aseprite CLI command to convert it. Commands are returned for external execution.

Inputs: session_id (required), output_name.

art.aseprite.layersA

Generate a Lua script and Aseprite command to set up standard layer structure. Writes the script to disk and returns the command to execute it.

Inputs: session_id (required), layers.

art.aseprite.spritesheetB

Generate a spritesheet export command for a canvas session. The canvas PNG is saved and a CLI command is returned to produce a packed spritesheet via Aseprite.

Inputs: session_id (required), columns, padding.

art.aseprite.validateB

Generate a validation Lua script and Aseprite command to check sprite constraints (palette size, dimensions). Writes the script to disk and returns the command.

Inputs: width (required), height (required), max_colors (required), session_id (required).

art.asset.approval.inspectB

Get an approval record by ID.

Inputs: approval_id (required).

art.asset.approval.requestC

Request approval for a candidate asset.

Inputs: actor (required), style (required), asset_id (required), candidate_id (required), +3 more.

art.asset.approveC

Approve a candidate asset.

Inputs: actor (required), approval_id (required), reason.

art.asset.archiveB

Archive an asset (remove from active use).

Inputs: id (required).

art.asset.archive_versionC

Archive a canonical asset, removing it from active use.

Inputs: actor (required), asset_id (required).

art.asset.compareB

Compare two versions of an asset.

Inputs: asset_id (required), version_a (required), version_b (required).

art.asset.currentB

Get the canonical (current) version number of an asset.

Inputs: asset_id (required).

art.asset.deprecateC

Mark an asset as deprecated.

Inputs: id (required).

art.asset.existsA

Check whether an asset with the given ID exists in the registry.

Inputs: id (required).

art.asset.findA

Search and filter registered assets. All parameters are optional; omit all to return every asset.

Inputs: tags, type, status, category, +2 more.

art.asset.getA

Get a registered asset by its ID. Returns the full asset record.

Inputs: id (required).

art.asset.historyC

Get the full version history of an asset.

Inputs: asset_id (required).

art.asset.inspect_versionB

Get details of a specific asset version.

Inputs: version (required), asset_id (required).

art.asset.promoteC

Promote an approved candidate to become the canonical version.

Inputs: actor (required), style (required), approval_id (required), artifact_id (required), +7 more.

art.asset.provenanceC

Get version provenance including approval record.

Inputs: version (required), asset_id (required).

art.asset.rebuild_indexA

Rebuild the asset registry index from all registered asset files.

Inputs: no named parameters.

art.asset.registerA

Register a new asset in the registry. Validates schema, style reference, source file, and relationships.

Inputs: id (required), name (required), type (required), style (required), +8 more.

art.asset.rejectC

Reject a candidate asset.

Inputs: actor (required), approval_id (required), reason, feedback.

art.asset.request_changesC

Request changes on a candidate asset.

Inputs: actor (required), feedback (required), approval_id (required), reason.

art.asset.rollbackB

Rollback the canonical version to a previous version.

Inputs: actor (required), asset_id (required), target_version (required), expected_current_version (required).

art.asset.updateC

Update an existing asset. Provide the asset ID and a patch object with fields to change.

Inputs: id (required), patch (required).

art.canvas.analyze_refA

Analyze a reference image: extract dimensions, color palette with counts, and 2D color map.

Inputs: image_path (required).

art.canvas.batch_drawA

Execute multiple draw commands in a single call for efficiency. Each command references a canvas tool name and its params.

Inputs: commands (required), session_id (required).

art.canvas.clearB

Clear the entire canvas, optionally filling with a color.

Inputs: session_id (required), color.

art.canvas.createB

Create a new pixel canvas session for drawing.

Inputs: session_id (required), width, height, asset_id, +1 more.

art.canvas.draw_circleB

Draw a circle on the canvas.

Inputs: cx (required), cy (required), color (required), radius (required), +2 more.

art.canvas.draw_ditherB

Apply a dither pattern to a rectangular region.

Inputs: x (required), y (required), width (required), color1 (required), +4 more.

art.canvas.draw_lineA

Draw a line between two points using Bresenham algorithm.

Inputs: x0 (required), x1 (required), y0 (required), y1 (required), +2 more.

art.canvas.draw_noiseC

Fill a region with random noise using specified colors.

Inputs: x (required), y (required), width (required), colors (required), +3 more.

art.canvas.draw_rectB

Draw a rectangle on the canvas.

Inputs: x (required), y (required), color (required), width (required), +3 more.

art.canvas.fillB

Flood fill an area starting from a point.

Inputs: x (required), y (required), color (required), session_id (required).

art.canvas.get_pixelB

Read the color of a single pixel on the canvas.

Inputs: x (required), y (required), session_id (required).

art.canvas.get_stateA

Get the current canvas state as a color map (2D hex array) or base64 PNG.

Inputs: session_id (required), format.

art.canvas.saveA

Save the current canvas to a PNG file.

Inputs: session_id (required), output_path.

art.canvas.set_pixelB

Set a single pixel on the canvas.

Inputs: x (required), y (required), color (required), session_id (required).

art.critic.evaluateB

Run the art critic to evaluate canvas quality with spatial scoring and issue detection.

Inputs: session_id (required), profile.

art.critic.refineC

Execute refinement actions from a critique to improve canvas quality.

Inputs: actions (required), session_id (required).

art.detail.cavityB

Add cavity details (dark center with light rim) to a region.

Inputs: x (required), y (required), seed (required), count (required), +5 more.

art.detail.clean_clustersC

Cleanup pass: merge orphan/isolated pixels into nearest larger cluster.

Inputs: session_id (required), min_cluster_size.

art.detail.clusterC

Create a pixel cluster on the canvas at a given position with a specified shape.

Inputs: cx (required), cy (required), size (required), color (required), +3 more.

art.detail.crackB

Add crack patterns to a region (stone, ice surfaces).

Inputs: x (required), y (required), seed (required), color (required), +4 more.

art.detail.edge_breakB

Apply edge breakup to avoid perfectly geometric silhouettes.

Inputs: seed (required), amount (required), session_id (required), preserve_outline.

art.detail.executeC

Run the full detail pass pipeline on an existing canvas session. Requires content already drawn on canvas.

Inputs: materials (required), session_id (required), seed, profile.

art.detail.grainA

Add directional grain lines to a region (wood, cloth).

Inputs: x (required), y (required), seed (required), color (required), +5 more.

art.detail.highlightC

Add highlight clusters to a region for specular/light reflection.

Inputs: x (required), y (required), seed (required), color (required), +4 more.

art.detail.materialB

Apply a full material treatment (all texture patterns for that material) to a region.

Inputs: x (required), y (required), seed (required), width (required), +3 more.

art.detail.passC

Run a single named detail pass on a canvas session.

Inputs: materials (required), pass_name (required), session_id (required).

art.detail.planB

Create a detail art plan for an asset, specifying subject, resolution, materials, and detail profile.

Inputs: width (required), height (required), subject (required), materials (required), +2 more.

art.detail.shadowA

Add shadow clusters to a region for depth/occlusion.

Inputs: x (required), y (required), seed (required), color (required), +4 more.

art.detail.speckleA

Add scattered speckle dots to a region (dirt, stone, skin).

Inputs: x (required), y (required), seed (required), width (required), +4 more.

art.detail.textureC

Apply a texture pattern to a rectangular region on the canvas.

Inputs: x (required), y (required), seed (required), width (required), +5 more.

art.get_paletteB

Returns the color palette for the active style.

Inputs: no named parameters.

art.get_project_contextA

Returns the full art context: project config, active style definition, all rule categories, and palette.

Inputs: no named parameters.

art.get_styleA

Returns the active style definition. Optionally specify style_id and version to look up a specific style.

Inputs: version, style_id.

art.get_style_rulesB

Returns the rules for a specific category of the active style.

Inputs: category (required).

art.memory.add_anchorC

Add a new style anchor to the art memory.

Inputs: id (required), name (required), style (required), assets (required), +6 more.

art.memory.add_decisionC

Add a new art decision record to the art memory.

Inputs: id (required), style (required), title (required), reason (required), +6 more.

art.memory.add_referenceC

Add a new approved reference to the art memory.

Inputs: id (required), roles (required), style (required), status (required), +5 more.

art.memory.add_rejectionB

Add a new rejection record to the art memory.

Inputs: id (required), type (required), style (required), status (required), +5 more.

art.memory.explain_styleA

Explain the current or specified style: core rules, canonical anchors, important decisions, things to avoid, and history.

Inputs: style_id, style_version.

art.memory.find_anchorsC

Search for style anchors with optional filters.

Inputs: status, category, style_id, dimension, +1 more.

art.memory.find_decisionsB

Search for art decision records with optional filters.

Inputs: status, style_id, style_version.

art.memory.find_referencesC

Search for approved references with optional filters.

Inputs: role, status, asset_id, style_id, +1 more.

art.memory.find_rejectionsC

Search for rejection records with optional filters.

Inputs: type, reason, status, style_id, +1 more.

art.memory.get_anchorA

Get a style anchor by its ID.

Inputs: id (required).

art.memory.get_decisionA

Get an art decision record by its ID.

Inputs: id (required).

art.memory.get_referenceC

Get an approved reference by its ID.

Inputs: id (required).

art.memory.get_rejectionA

Get a rejection record by its ID.

Inputs: id (required).

art.memory.get_style_historyB

Get the full style evolution history.

Inputs: no named parameters.

art.memory.get_summaryA

Get a summary of the art memory: anchor count, active decisions, active rejections, total references.

Inputs: no named parameters.

art.memory.insightsA

Get style insights derived from approved assets — patterns, preferences, and learned conventions from the asset corpus.

Inputs: no named parameters.

art.memory.negativeA

Get negative patterns (rejected examples) for a type/material — query rejections filtered by type hints in reasons.

Inputs: type, material.

art.memory.resolve_referencesD

Resolve relevant references, anchors, decisions, and rejections for a given context. Returns categorized results.

Inputs: type, category, style_id, dimensions, +1 more.

art.memory.signatureA

Compute a visual signature (deterministic fingerprint) for a canvas session — color distribution, cluster stats, edge complexity, etc.

Inputs: session_id (required).

art.pipeline.analyzeB

Analyze a reference image. Returns palette, silhouette, composition, pixel characteristics. Provide either a file path or reference_id of an already-uploaded reference.

Inputs: pose, facing, subject, category, +2 more.

art.pipeline.planA

Build a 7-stage ArtPlan (silhouette-first) from an ArtSpecification. The plan defines ordered generation stages with QA checkpoints.

Inputs: reference_id (required), max_iterations.

art.pipeline.scoreC

Compute visual quality score for a pixel art asset. Scores silhouette, palette, composition, pixel cleanliness, and style match.

Inputs: asset_path (required), reference_id.

art.pipeline.specB

Build an ArtSpecification from a reference analysis + active style. The spec defines canvas, palette, outline, shading constraints for pixel art generation.

Inputs: reference_id (required), subject, max_colors, canvas_width, +1 more.

art.production.approveB

Approve a production job that is awaiting approval, moving it to completed.

Inputs: job_id (required).

art.production.attemptsB

Get the attempt history for a production job.

Inputs: job_id (required).

art.production.cancelC

Cancel a production job.

Inputs: job_id (required).

art.production.createB

Create a production job (plan + persist, does not start execution).

Inputs: output (required), subject (required), asset_type (required), request_id (required), +5 more.

art.production.inspectC

Get full details of a production job including events, attempts, and plan.

Inputs: job_id (required).

art.production.listB

List all production job IDs.

Inputs: no named parameters.

art.production.planB

Create a production plan for an art asset (inspect before executing).

Inputs: output (required), subject (required), asset_type (required), request_id (required), +5 more.

art.production.resumeA

Resume a failed or interrupted production job.

Inputs: job_id (required).

art.production.startC

Start executing a production job.

Inputs: job_id (required).

art.production.statusC

Get the current status of a production job.

Inputs: job_id (required).

art.provider.analyzeB

Analyze a PNG file using the canvas-analysis provider. Runs local analysis (signature, clusters, palette) without external APIs.

Inputs: operation (required), source_path (required), style, asset_id, +2 more.

art.provider.artifactB

Get details of a generated artifact.

Inputs: artifact_id (required).

art.provider.cancelC

Cancel a running provider operation.

Inputs: operation_id (required).

art.provider.capabilitiesB

Get the capabilities of a specific provider.

Inputs: provider_id (required).

art.provider.executeC

Execute an art generation operation via a provider.

Inputs: style (required), operation (required), provider_id (required), output, +6 more.

art.provider.fallbackC

Execute an art operation with fallback — tries the primary provider, falls back to a secondary on failure.

Inputs: style (required), operation (required), provider_id (required), output, +7 more.

art.provider.getA

Get detailed metadata for a specific provider.

Inputs: provider_id (required).

art.provider.healthB

Check the health status of a specific provider.

Inputs: provider_id (required).

art.provider.health_allA

Check health of all registered providers. Returns a map of provider ID to health status with latency and consecutive failure count.

Inputs: no named parameters.

art.provider.listA

List all registered art providers with their metadata.

Inputs: no named parameters.

art.provider.operationC

Get the status of a provider operation.

Inputs: operation_id (required).

art.qa.assetA

Run QA checks on a single asset. Returns a full QA report with all rule results.

Inputs: asset_id (required), profile.

art.qa.batchA

Run QA checks on multiple assets at once. Returns a batch report with individual results.

Inputs: asset_ids (required), profile.

art.qa.explain_failureA

Explain why a specific QA rule failed for an asset. Returns rule definition, issue details, and context.

Inputs: rule_id (required), asset_id (required).

art.qa.gateB

Run a QA gate check on an asset. Returns pass/fail verdict with full report.

Inputs: asset_id (required), profile.

art.qa.historyC

Get QA run history. Optionally filter by asset ID.

Inputs: asset_id.

art.qa.list_rulesA

List all available QA rules with their definitions.

Inputs: no named parameters.

art.qa.ruleA

Get the full definition of a specific QA rule by its ID.

Inputs: rule_id (required).

art.ref.canonicalA

Get canonical assets for a type/material — filters retrieve results to only canonical status entries.

Inputs: type, material.

art.ref.packB

Build a reference pack for generation — combines style constraints, canonical references, negative examples, and material palette.

Inputs: type, category, material, max_negative, +1 more.

art.ref.retrieveB

Smart ranked reference retrieval — scores and returns top assets by canonical status, style match, material match, and recency.

Inputs: type, category, material, max_results.

art.style.bootstrapA

Get session bootstrap context — assembles project config, style, canonical assets, anti-patterns, and recent decisions into one payload.

Inputs: no named parameters.

art.style.checkA

Run style consistency check on a canvas session — compares canvas content against compiled style constraints.

Inputs: session_id (required), material.

art.style.compileB

Compile style constraints for a subject — merges style definition, optional material profile, and resolution into a flat StyleConstraints object.

Inputs: width, height, profile, material.

art.style.repairA

Generate a repair plan from a style consistency check — identifies actions to fix style issues on a canvas.

Inputs: session_id (required), material.

art.tilemap.build_opsB

Generate TiledMCP operations from a MapSpecification. Returns the operation sequence for TiledMCP provider execution.

Inputs: map_id (required).

art.tilemap.create_specC

Create a MapSpecification for tilemap generation. Defines map size, biome, layers, objects, terrain rules.

Inputs: biome (required), width (required), height (required), layers (required), +6 more.

art.tilemap.list_tilesetsA

List all registered tileset definitions.

Inputs: no named parameters.

art.tilemap.register_tilesetB

Register a tileset definition with semantic tile metadata. Each tile gets an ID, terrain, walkability, collision info.

Inputs: tiles (required), asset_id (required), tile_size (required), tileset_id (required), +2 more.

art.tilemap.resolve_tilesA

Resolve semantic tile names to tileset local IDs. Use to verify tile names before building a map.

Inputs: intents (required), tileset_id (required).

art.tilemap.validateA

Validate a MapSpecification against its tileset. Checks missing tiles, invalid refs, style mismatch, object bounds.

Inputs: map_id (required).

art.validate_styleB

Validates the active style configuration and returns any errors found.

Inputs: no named parameters.

art.workflow.guideA

Generate a step-by-step painting guide for the AI to follow when drawing a subject. Enforces strict palette discipline, form-first/detail-last hierarchy, and per-step color limits. The guide is TEXT instructions — read it and follow each step sequentially.

Inputs: subject (required), width, height, profile, +1 more.

art.workflow.paletteA

Get the strict palette for a material — returns role-to-hex mappings, maximum color count, and forbidden colors. Use this before painting to know EXACTLY which colors are allowed.

Inputs: material.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 126 tools

    Disambiguation3/5

    The hierarchical namespaces help, but the sheer number of tools creates real overlap: art.provider.analyze vs art.pipeline.analyze, art.asset.archive vs art.asset.archive_version, and art.qa.asset vs art.critic.evaluate vs art.style.check all have fuzzy boundaries. An agent could easily pick the wrong one without very careful descriptions.

    Naming Consistency4/5

    Most tools follow a predictable art.<category>.<action> pattern with snake_case verbs, which is highly readable. However, a few top-level tools like art.validate_style, art.get_style, and art.get_palette break the convention, and verbs are mixed across add/register/create for similar operations.

    Tool Count1/5

    126 tools is an extreme count for any MCP server, far beyond the 25+ threshold. Many micro-tools—individual detail effects, memory CRUD variants, and Aseprite command generators—could be consolidated into broader operations, making the surface unnecessarily hard to navigate.

    Completeness5/5

    The tool surface is remarkably comprehensive for a game-art domain: asset lifecycle, versioning, approvals, style memory, QA, providers, canvas painting, production jobs, tilemaps, detail passes, Aseprite export, and workflow guidance are all covered. Major workflows have no obvious dead ends.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI coding agents to create, draw, and refine Aseprite documents through deterministic canvas, layer, frame, tag, and palette tools, with pixel analyzers, style validation, and preview/diff visual feedback. It also supports spritesheet and animated GIF export, producing multi-layer game-ready assets.
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables users to automate the creation, editing, animation, and export of pixel-art game assets through a multi-agent pipeline that derives style specs and blueprints, generates Lua build scripts, and drives the canvas editor to produce .aseprite files, spritesheets, atlases, GIFs, and previews.
      12
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to create and edit pixel-art projects — sprites, props, palettes, eight-direction animation, and tile-based environments — through a stdio MCP server with discovery, help, and call tools. Agents can build from silhouette to detail, inspect native-scale renders, silhouettes, value maps, and GIF playback, then save every change as versionable source.
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables MCP-capable coding agents to act as a deterministic technical art director and multi-engine pipeline builder, locking AI-generated 2D/2.5D game assets to consistent camera angles, palettes, rigs, atlases, and exports across Blender, ComfyUI, UniRig, LibreSprite, Godot 4, Unity, and Unreal Engine 5.
      24
      MIT