- 去掉版本号后缀,路径更稳定(后续更新工具不必再改 .mcp.json) - .mcp.json 指向新路径 server/build/index.js - server 依赖已 npm install 就绪;node_modules 由 .gitignore 忽略,未入库 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
93 lines
5.7 KiB
JavaScript
93 lines
5.7 KiB
JavaScript
import { z } from "zod";
|
|
import { formatErrorForMcp } from "../utils/errors.js";
|
|
export function registerTilemapTools(server, godot) {
|
|
server.tool("tilemap_set_cell", "Set a single cell in a TileMapLayer (or a deprecated multi-layer TileMap node)", {
|
|
node_path: z.string().describe("Path to the TileMapLayer or deprecated TileMap node"),
|
|
x: z.number().describe("Cell X coordinate"),
|
|
y: z.number().describe("Cell Y coordinate"),
|
|
source_id: z.number().optional().describe("Tile source ID (default: 0)"),
|
|
atlas_x: z.number().optional().describe("Atlas X coordinate (default: 0)"),
|
|
atlas_y: z.number().optional().describe("Atlas Y coordinate (default: 0)"),
|
|
alternative: z.number().optional().describe("Alternative tile ID (default: 0)"),
|
|
layer: z.number().optional().describe("Layer index for deprecated multi-layer TileMap nodes (default: 0; TileMapLayer has one implicit layer and only accepts 0)"),
|
|
}, async (params) => {
|
|
try {
|
|
const result = await godot.sendCommand("tilemap_set_cell", params);
|
|
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
}
|
|
catch (e) {
|
|
return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
|
|
}
|
|
});
|
|
server.tool("tilemap_fill_rect", "Fill a rectangular region of a TileMapLayer (or a deprecated multi-layer TileMap node) with tiles", {
|
|
node_path: z.string().describe("Path to the TileMapLayer or deprecated TileMap node"),
|
|
x1: z.number().describe("Start X coordinate"),
|
|
y1: z.number().describe("Start Y coordinate"),
|
|
x2: z.number().describe("End X coordinate"),
|
|
y2: z.number().describe("End Y coordinate"),
|
|
source_id: z.number().optional().describe("Tile source ID (default: 0)"),
|
|
atlas_x: z.number().optional().describe("Atlas X coordinate (default: 0)"),
|
|
atlas_y: z.number().optional().describe("Atlas Y coordinate (default: 0)"),
|
|
alternative: z.number().optional().describe("Alternative tile ID (default: 0)"),
|
|
layer: z.number().optional().describe("Layer index for deprecated multi-layer TileMap nodes (default: 0; TileMapLayer has one implicit layer and only accepts 0)"),
|
|
}, async (params) => {
|
|
try {
|
|
const result = await godot.sendCommand("tilemap_fill_rect", params);
|
|
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
}
|
|
catch (e) {
|
|
return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
|
|
}
|
|
});
|
|
server.tool("tilemap_get_cell", "Get tile data at a specific cell in a TileMapLayer (or a deprecated multi-layer TileMap node)", {
|
|
node_path: z.string().describe("Path to the TileMapLayer or deprecated TileMap node"),
|
|
x: z.number().describe("Cell X coordinate"),
|
|
y: z.number().describe("Cell Y coordinate"),
|
|
layer: z.number().optional().describe("Layer index for deprecated multi-layer TileMap nodes (default: 0; TileMapLayer has one implicit layer and only accepts 0)"),
|
|
}, async (params) => {
|
|
try {
|
|
const result = await godot.sendCommand("tilemap_get_cell", params);
|
|
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
}
|
|
catch (e) {
|
|
return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
|
|
}
|
|
});
|
|
server.tool("tilemap_clear", "Clear cells in a TileMapLayer (or a deprecated multi-layer TileMap node). For a legacy TileMap, omit layer to clear all layers or pass a layer to clear just that one", {
|
|
node_path: z.string().describe("Path to the TileMapLayer or deprecated TileMap node"),
|
|
layer: z.number().optional().describe("Layer index for deprecated multi-layer TileMap nodes; omit to clear all layers (TileMapLayer only accepts 0)"),
|
|
}, async (params) => {
|
|
try {
|
|
const result = await godot.sendCommand("tilemap_clear", params);
|
|
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
}
|
|
catch (e) {
|
|
return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
|
|
}
|
|
});
|
|
server.tool("tilemap_get_info", "Get TileMapLayer (or deprecated multi-layer TileMap) info including tile set sources, per-layer breakdown, and cell count", {
|
|
node_path: z.string().describe("Path to the TileMapLayer or deprecated TileMap node"),
|
|
}, async (params) => {
|
|
try {
|
|
const result = await godot.sendCommand("tilemap_get_info", params);
|
|
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
}
|
|
catch (e) {
|
|
return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
|
|
}
|
|
});
|
|
server.tool("tilemap_get_used_cells", "Get a list of used (non-empty) cells in a TileMapLayer (or a deprecated multi-layer TileMap node)", {
|
|
node_path: z.string().describe("Path to the TileMapLayer or deprecated TileMap node"),
|
|
max_count: z.number().optional().describe("Maximum cells to return (default: 500)"),
|
|
layer: z.number().optional().describe("Layer index for deprecated multi-layer TileMap nodes (default: 0; TileMapLayer has one implicit layer and only accepts 0)"),
|
|
}, async (params) => {
|
|
try {
|
|
const result = await godot.sendCommand("tilemap_get_used_cells", params);
|
|
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
}
|
|
catch (e) {
|
|
return { content: [{ type: "text", text: formatErrorForMcp(e) }], isError: true };
|
|
}
|
|
});
|
|
}
|
|
//# sourceMappingURL=tilemap-tools.js.map
|