MCP ツール一覧

AI 接続 (MCP) で AI が呼び出せるツールの全一覧です。ツール名と引数名は、コードと同じ英語のまま記載します。設定方法は AI 接続 (MCP) を参照してください。

読み方

表記	意味
*引数	必ず指定する必要がある引数です。
読み取り	ワールドを変更しません。
ライブ	エディターが開いているとき (ライブモード) のみ使えます。
1 ステップ	元に戻すの 1 ステップとして記録されます。

• 座標はブロック単位で、x = 東、y = 上、z = 南です。min ・ max はボックスの 2 つの角 (両端を含む) です。
• ブロックは stone_bricks ・ oak_stairs[facing=east] のように書きます。省略したプロパティは既定値です。
• パターンは 70%stone,30%andesite のように割合で混ぜるか、grad(y: a→b→c) で高さのグラデーションを使います。
• set_blocks ・ fill ・ shape ・ replace ・ transform ・ build ・ generate には connect 引数もあります。既定は true で、フェンス・板ガラス・鉄格子・塀・階段の角を隣とつなげます。
• 多くの編集ツールに name 引数があります。アウトライナーに表示されるアクター名です。

状態・ワールド

ツール	役割	主な引数
status	モード (ライブ/ファイル)・開いているファイル・未保存の変更・ブロック数・範囲・選択・元に戻すの数・カメラを返します。最初に呼び出します。読み取り	—
world_new	空の新しいワールドを開きます。未保存の変更があれば拒否します。	discard_unsaved
world_open	.npworld ファイルを開きます。未保存の変更があれば拒否します。	*path ・ discard_unsaved
world_save	.npworld として保存します。同じ名前があれば _vN を付けます。	path ・ overwrite (現在開いているファイルのみ)
undo ・ redo	元に戻す・やり直し (ユーザーの編集を含む)	steps (1〜50)
actors	アクターの一覧・削除・非表示・表示・選択・名前の変更・複製・移動・変換・親・新規フォルダー・ロック・床に下ろす。1 ステップ	*action ・ name ・ new_name ・ filter ・ offset ・ pos ・ rot ・ size ・ parent
select	エディターの選択ボックスを設定またはクリアします。	min ・ max ・ clear

読み取り

ツール	役割	主な引数
inspect_region	ボックスの要約 — ブロック数・実際の範囲・層ごとの数・多いブロック。読み取り	*min ・ *max ・ top
read_blocks	ボックスのブロックを、層ごとの断面の文字図 (4 万マスまで) または一覧 (6 千個まで) で読み取ります。読み取り	*min ・ *max ・ format (slices ・ list)・axis
surface	柱ごとの最上部ブロックの高さと種類を文字で表示します。読み取り	*min ・ *max ・ step
find_blocks	条件に合うブロックの位置を探します (lantern ・ * など)。読み取り	*match ・ min ・ max ・ limit
block_search	単語でブロック id を探します (brick stairs)。読み取り	*query ・ limit
block_info	ブロック 1 つの既定ステート・プロパティと許可値・同じ素材の系列・色・似たブロック。読み取り	*block
palette	色によるブロック選択・似たブロック・ブロックのグラデーション。jar が必要です。読み取り	color ・ like ・ gradient ・ steps ・ count ・ include_slabs_stairs ・ face

編集

ツール	役割	主な引数
set_blocks	マスごとにブロックを配置します (10 万マスまで)。1 ステップ	*blocks ・ state
fill	ボックスをブロック・パターンで埋めます (塗りつぶし・中空・壁のみ / 上書き・空きマスのみ・塗り・削除)。1 ステップ	*min ・ *max ・ pattern ・ form ・ mode ・ seed
shape	球・楕円体・円柱・円錐・ピラミッド・ボックス・線・アーチ・スロープ (階段) を配置します。1 ステップ	*shape ・ pattern ・ at ・ anchor ・ radius ・ radii ・ height ・ size ・ axis ・ hollow ・ from ・ to ・ direction ・ stairs
replace	ボックス内 (既定はワールド全体) の一致するブロックを置き換えます。アクターはそのままです。1 ステップ	*from ・ *to ・ min ・ max ・ seed
clear	ボックス内のブロックをすべて削除します。1 ステップ	*min ・ *max
transform	ボックスのブロックを移動・回転・反転・積み重ね (配列)・複製します。1 ステップ	*op ・ *min ・ *max ・ offset ・ quarters ・ axis ・ direction ・ count ・ gap ・ to
build	複数の編集を順番に、1 ステップ・1 アクターとして実行します。エラーがあればすべて元に戻します。	*ops
generate	屋根・窓・扉・柱・ハーフティンバー・木・岩・地形 (島・丘) を作ります。1 ステップ	*kind ・ min ・ max ・ at ・ preset ・ settings ・ seed

オーサリング

ツール	役割	主な引数
build_script	変数・ループ・条件・テンプレートを持つ JSON の建築プログラムで、壁・建物・屋根 (11 種類)・塔・アーチ・橋・道などを建てます。1 ステップ	script ・ origin ・ rotate ・ mirror ・ seed ・ dry_run ・ help
furnish	部屋 1 つを用途・様式に合わせて家具・照明・装飾で飾ります。1 ステップ	*min ・ *max ・ *purpose ・ style ・ seed ・ dry_run
furnish_building	建物内の部屋を階ごとに見つけ、それぞれを飾ります。1 ステップ	*min ・ *max ・ type ・ purposes ・ style ・ min_area ・ dry_run
terrain_sculpt	既存の地面を、ブラシ・多角形・曲線の通路・ボックスで、上げる・下げる・平らにする・滑らかにする・段々にする・ノイズ・崖・塗りを行います。建物のマスはスキップします。1 ステップ	*op ・ center ・ radius ・ polygon ・ points ・ width ・ min ・ max ・ amount ・ height ・ strength ・ material ・ protect ・ dry_run

地形・自然

ツール	役割	主な引数
terrain_water	川・自動の川・湖・滝・海岸・閉じた窪地の充填。1 ステップ	*op ・ points ・ at ・ top ・ min ・ max ・ radius ・ width ・ depth ・ sea_level ・ fluid
terrain_shape	オーバーハング・侵食・洞窟・道 (切土・盛土・橋)・素材ルール・ハイトマップ PNG のエクスポート/インポート。1 ステップ	*op ・ min ・ max ・ at ・ radius ・ points ・ pattern ・ path ・ min_height ・ max_height
scatter	木・草・花・岩・プロップを、間隔・密度・傾斜・高さの条件で散布します。1 ステップ	preset ・ items ・ min ・ max ・ at ・ radius ・ min_distance ・ density ・ max_slope ・ ground ・ seed
props	カスタムモデルのプロップを自由変換で配置・修正・複製・削除します。1 ステップ	*action ・ model ・ id ・ pos ・ rot ・ scale ・ offset ・ actor ・ filter

AI マップジェネレーター

ツール	役割	主な引数
blueprints	建てられるパーツ・引数・様式・マップ設計図の形式と例を返します。読み取り	section (all ・ parts ・ map_spec)
place_blueprint	パーツ 1 つ (家・塔・殿堂・城・道・広場・噴水・ポータル・露店・井戸・街灯・橋・城壁・大階段・木・岩) を既存の地面の上に建てます。1 ステップ	*blueprint ・ params ・ detail ・ style ・ seed
build_map	マップ設計図 (np-mapspec) で、地形 → 道 → 構造物 → 村 → 自然を一度に建てます (1024×1024 まで)。1 ステップ	*spec ・ detail ・ style ・ review

• detail = low (塊のみ)・medium (通常の建築)・high (バニラ最大のディテール)・max (high + 装飾)
• style = medieval ・ fantasy_kingdom ・ nordic ・ desert

表示

ツール	役割	主な引数
camera	エディターのカメラを移動するか、ボックスに合わせます。ライブ	from ・ look_at ・ fov ・ frame_min ・ frame_max ・ view
screenshot	ビューポートを画像として撮影して返します。読み取り・ライブ	camera の引数 + width ・ height ・ render (shader ・ raytraced ・ lit ・ unlit)・time_of_day
map_image	上から見た地図画像 (高さの陰影・水の青) を作ります。エディターなしでも使えます。読み取り	*min ・ *max ・ scale ・ grid
view_image	CPU による 3D レンダー画像 (アイソ・上・斜め・側面・目の高さ・近接・ユーザーカメラ) を作ります。エディターなしでも使えます。読み取り	min ・ max ・ view ・ from ・ look_at ・ pos ・ heading ・ pitch ・ fov ・ zoom ・ width ・ height ・ outline ・ mark_min ・ mark_max ・ sun ・ shadows ・ exposure
view_sheet	アイソの 4 方向 (2×2) を 1 枚の画像にします。四方の確認に最も速い方法です。読み取り	min ・ max ・ size ・ outline ・ sun ・ shadows

シェーダー・リソースパック・空

ツール	役割	主な引数
shader_looks	ルックのプリセット (英語 id・名前・全値)・保存したルック・現在のルック・値の名前と範囲を表示します。読み取り	—
shader_look	ルックを表示または変更します。プリセットの上に部分的な値をマージします。ライブならプレビューにすぐ反映されます。	preset ・ values ・ name ・ reset ・ save
shader_formulas	ルックで変更できるシェーダー関数 (数式) の一覧と既定の GLSL を表示します。読み取り	id
build_shaderpack	現在のルックで NP Lite シェーダーパック NP-Lite_<名前>_vN.zip を作ります。	preset ・ values ・ name ・ folder
build_resourcepack	登録簿から完成したリソースパック <名前>_rp_vN.zip + .sha1.txt + レポートを作ります。	name ・ folder ・ description ・ version_label ・ url ・ icon ・ allow_minecraft_namespace ・ server_registry ・ write_even_if_errors
items	登録簿の項目 (配置の種類・アイテムの種類・アイテムモデル・表示・防具・エフェクト) を表示します。読み取り	filter
item_set	項目 1 つのアイテムの種類・アイテムモデル id・手に持ったときの見た目・防具の画像・エフェクトのフレームを変更して保存します。	*id ・ item_kind ・ item_model ・ display ・ armor ・ effect ・ allow_minecraft_namespace
sky	空の装飾 (太陽・月・雲) を表示・変更・リセットします。	*action (get ・ set ・ reset)・settings

サウンド

ツール	役割	主な引数
sounds	サウンドイベント・ファイルの状態・カスタムブロックのサウンド・合成レシピの一覧。読み取り	section ・ filter
sound_set	サウンドイベント 1 つを作成または変更します (バニラの置き換えを含む)。	*id ・ files ・ add_files ・ replace ・ subtitle ・ remove
sound_generate	内蔵シンセサイザーで著作権の心配がないサウンドを作り、登録します。recipe=starter_pack はスターターサウンド一式です。	*recipe ・ seed ・ variants ・ event ・ namespace ・ mode ・ volume ・ replace_existing
block_sounds_set	カスタムブロックの破壊・配置・歩行・叩く・落下のサウンドを設定します。	*block ・ preset (stone ・ wood ・ crystal)・break ・ place ・ step ・ hit ・ fall ・ clear

ワールドロジック・アクター

ツール	役割	主な引数
scene_rules	ワールドロジックのルール一覧とチェック、使えるシーンアクター、トリガー・条件・アクションの type の項目 (schema) を表示します。読み取り	section (actors ・ schema など)・id
scene_rule_set	ルール 1 つを作成・変更・削除・並べ替えします。変数・enum・データ型も設定します。チェックエラーがあれば拒否します。1 ステップ	rule ・ delete ・ index ・ force ・ variables ・ enums ・ types
anim_clips	アニメーションクリップの一覧とチェック、クリップの JSON を表示します。読み取り	id
anim_clip_set	クリップ 1 つを作成・変更・削除します (トラック・カメラカット・イベント・サウンド・タイトル・フェード)。1 ステップ	clip ・ delete ・ force
meta_actor	ブロックのないアクター (フォグボリューム・ルックボリューム・サウンドエミッター・シーンアクター trigger ・ spawn ・ display ・ text ・ light ・ camera ・ path ・ blocker) を作成・修正・削除・複製します。1 ステップ	*action ・ kind ・ name ・ at ・ preset ・ settings ・ offset
actor_components	アクターコンポーネント (trigger_volume ・ blocking_volume ・ interactable ・ sound_emitter ・ light ・ text_label ・ tags ・ logic) を追加・修正・削除・オン/オフします。1 ステップ	*action ・ actor ・ type ・ component ・ props ・ replace

設計

ツール	役割	主な引数
bom	ボックス・アクター・ワールドの資材リスト (アイテム数・スタック・シュルカー) と原材料の推定。読み取り	min ・ max ・ actor ・ format ・ raw
design_report	マーカーの設計チェック (地域の重なり・スポーン位置・ワープの接続・埋まり/浮き・命名ルール) と地域ごとの内容表、企画表。読み取り	format ・ sheet ・ lint ・ placement ・ fix_names
travel_times	ワープ・プレイヤースポーン・村の中心の間の直線距離と歩行経路・歩き/走りの時間。読み取り	walk ・ all_regions

エクスポート

ツール	役割	主な引数
export	ワールド (またはボックス) を .schem ・ Minecraft のワールドフォルダーとして新しいフォルダーにエクスポートします (1.21.11)。	*name ・ format (schem ・ world ・ both)・min ・ max ・ spawn ・ game_mode ・ biome ・ time ・ folder

Web 3D ビューアー

ツール	役割	主な引数
world_info	ビューアープログラム用のワールド要約 JSON (16³ セクションの一覧・版・アクターのボックス・シーンアクター)。読み取り	sections ・ min ・ max ・ actors ・ catalog
world_chunks	16³ セクションのブロックデータ (パレット + 圧縮配列) の JSON。読み取り	sections ・ min ・ max ・ near ・ max_sections ・ max_bytes

関連ドキュメント

• AI 接続 (MCP)
• エクスポートとインポート
• 設計ツール
• ゲーム画面とシェーダーパック
• 空とサウンド