Skip to main content
Glama
dcd887

mc-pack-builder-mcp

export_standard_pack

Exports a standardized Minecraft modpack by cleaning extra files, unwrapping nested archives, generating a modlist, and optionally splitting large packs into volumes; returns a detailed operation report.

Instructions

导出规范格式的整合包:自动清理多余文件、解压嵌套压缩包、生成 modlist、可选分卷打包。返回详细操作报告。

Input Schema

NameRequiredDescriptionDefault
output_dirNo输出目录路径;不填则自动生成同名 _ready 子目录
minecraft_dirNo.minecraft 根目录路径,用于 clean_minecraft_extra
split_volumesNo是否将最终包按卷拆分(超大整合包时使用,每卷不超过 volume_max_mb MB)
unwrap_nestedNo是否解压顶层的嵌套 .zip 文件(如附加包、子包)并删除原压缩包
volume_max_mbNo每个卷的最大体积(MB),默认 256
modlist_formatNomodlist 格式,默认 html
source_pack_dirYes源整合包根目录路径,如 C:/Users/xxx/Desktop/MyModpack
generate_modlistNo是否生成 modlist.html(或 modlist.txt)
clean_minecraft_extraNo是否清理 .minecraft 中的 logs/crash-reports 等垃圾目录,需配合 minecraft_dir 使用

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.1.0

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description does useful work by disclosing automated cleanup, nested archive extraction, modlist generation, optional splitting, and a detailed operation report. However, it does not explicitly warn that cleanup or unwrapping can delete files, nor does it clarify whether the source pack is modified or how existing output is handled.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single compact sentence that front-loads the main action and then lists the key optional behaviors. It contains no filler and is appropriately sized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With nine parameters but full schema descriptions, the agent has enough structured detail to call the tool correctly. The description also states that a detailed operation report is returned, although it could more explicitly cover destructive side effects and preconditions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so every parameter already has structured documentation. The description summarizes optional behaviors such as volume splitting and modlist generation but adds no syntax, default, or edge-case meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: exporting a standardized modpack. It also names the core operations (cleanup, nested archive extraction, modlist generation, optional volume splitting), which clearly distinguishes it from create_pack and the read-only sibling tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The export purpose is inferable from the name and description, but there is no explicit guidance on when to choose this tool over create_pack or other siblings, nor any stated preconditions. Usage is implied rather than spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.