CodeCraft
by TanerTalas · remote · no sign-in to list tools · v0.1.0 · published by GitHub user TanerTalas
Checks whether generated Minecraft Bedrock content will actually load. Nine read-only tools.
9 tools: 3 change things and 6 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things3Claude Code: ask: see these tools
- Only reads6Claude Code: allow: see these tools
2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http codecraft https://codecraft-ashy-seven.vercel.app/mcpFindings
Matches of fixed checks, with the text they matched.
- Warnvalidate_script
The server marks "validate_script" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"openWorldHint":false}; The name "validate_script" says "validate": a word for reading.
- Warnvalidate_python
The server marks "validate_python" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"openWorldHint":false}; The name "validate_python" says "validate": a word for reading.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
9 tools
Changes things 3Claude Code: ask
check_feasibilityChecks whether a user request can be built with a behavior pack and the @minecraft/server API.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Checks whether a user request can be built with a behavior pack and the @minecraft/server API. If it is blocked, returns why, the evidence behind that rule, and a workable alternative. Call this BEFORE writing any code or JSON: input simulation, file system access and network access do not exist in the Bedrock scripting API, and those are the most commonly hallucinated APIs.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
validate_pythonValidates a Python automation script that runs OUTSIDE the game, on three axes: Python syntax (using the real interpreter), Minecraft commands embedded in the script (against the o…1 finding
Why it is in this group
- The name "validate_python" says "validate": a word for reading.
- The input takes a statement or command to run (input.code), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "validate_python" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"openWorldHint":false}; The name "validate_python" says "validate": a word for reading.
Description, as the server wrote it Validates a Python automation script that runs OUTSIDE the game, on three axes: Python syntax (using the real interpreter), Minecraft commands embedded in the script (against the official command index), and the shape of the /connect WebSocket message envelope. For behavior pack scripts use validate_script instead — Python does not run inside a pack. The embedded command check is the most valuable one: a command written from memory can look syntactically fine and still do nothing in the game. Only strings starting with / are treated as commands. If syntax could not be checked, syntaxChecked is false in the result; ok:true alone does not mean the syntax is valid.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
validate_scriptCompiles a behavior pack script with the real TypeScript compiler against the actual @minecraft/server type definitions for that version.1 finding
Why it is in this group
- The name "validate_script" says "validate": a word for reading.
- The input takes a statement or command to run (input.code), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "validate_script" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"openWorldHint":false}; The name "validate_script" says "validate": a word for reading.
Description, as the server wrote it Compiles a behavior pack script with the real TypeScript compiler against the actual @minecraft/server type definitions for that version. Returns diagnostics with line, column, TS error code and message, and reports which module versions it compiled against. Catch non-existent APIs and calls removed in later versions here — Bedrock scripting APIs written from memory are the most common source of output that fails silently.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
Only reads 6Claude Code: allow
get_schemaSummarises the schema of a Bedrock document type: required fields, valid format_version values, and the name, type and description of every field on that node.No findings
Why it is in this group
- The name "get_schema" says "get": a word for reading.
Description, as the server wrote it Summarises the schema of a Bedrock document type: required fields, valid format_version values, and the name, type and description of every field on that node. It does not return the raw schema — that is far too large. When a node has many fields the summary narrows and says what was shortened in the truncated field; use path to descend into a child node for full detail. Call this before writing a file to learn which fields are required and what format_version must be.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
get_version_infoReturns which version number belongs where for this game version: min_engine_version (a three-part array), @minecraft/server module versions, the valid format_version values for ev…No findings
Why it is in this group
- The name "get_version_info" says "get": a word for reading.
Description, as the server wrote it Returns which version number belongs where for this game version: min_engine_version (a three-part array), @minecraft/server module versions, the valid format_version values for every document type, and the list of recognised document types. format_version is an axis of its own and is unrelated to the game version. Call this before writing any behavior pack file.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
lookup_idTells you whether a minecraft: identifier actually exists in this version and what kind it is (block, item, entity, biome, effect, enchantment, feature, dimension, camera preset, p…No findings
Why it is in this group
- The name "lookup_id" says "lookup": a word for reading.
Description, as the server wrote it Tells you whether a minecraft: identifier actually exists in this version and what kind it is (block, item, entity, biome, effect, enchantment, feature, dimension, camera preset, particle, potion). For a block it also returns the valid block states and the values they accept. An identifier without a namespace is treated as minecraft:. Verify every identifier here before writing it — an identifier that does not exist fails silently in the game.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
review_packValidates every file of a behavior or resource pack in one call: it applies the right validator to each file (JSON schema, script compilation, command syntax) and then runs the che…No findings
Why it is in this group
- The description's first verb is "validate": a word for reading.
Description, as the server wrote it Validates every file of a behavior or resource pack in one call: it applies the right validator to each file (JSON schema, script compilation, command syntax) and then runs the checks a schema structurally cannot do — identifier consistency, filename rules, manifest module type, texture keys, component names, Molang queries and loot/trade table paths. This is the LAST step before handing a pack to the user, and it is both faster and broader than validating each file separately.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
validate_commandValidates a single Bedrock command line against the official command index: does the command exist, does the argument count match, are the selectors and block states valid.No findings
Why it is in this group
- The name "validate_command" says "validate": a word for reading.
Description, as the server wrote it Validates a single Bedrock command line against the official command index: does the command exist, does the argument count match, are the selectors and block states valid. When no overload matches it returns the valid usages, and it tells you whether the command requires cheats. Run every command through this before giving it to the user. `execute ... run <command>` chains are resolved: the command after run is validated too, including nested execute.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
validate_jsonValidates a behavior or resource pack JSON file against the official schema and returns the JSON pointer, the violated rule and a readable message for every error.No findings
Why it is in this group
- The name "validate_json" says "validate": a word for reading.
Description, as the server wrote it Validates a behavior or resource pack JSON file against the official schema and returns the JSON pointer, the violated rule and a readable message for every error. Unexpected property names and the valid enum values are included in the message. Run every JSON file you produce through this before handing it to the user.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.1.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http codecraft https://codecraft-ashy-seven.vercel.app/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__codecraft__get_version_info",
"mcp__codecraft__get_schema",
"mcp__codecraft__lookup_id",
"mcp__codecraft__validate_json",
"mcp__codecraft__validate_command",
"mcp__codecraft__review_pack"
],
"ask": [
"mcp__codecraft__check_feasibility",
"mcp__codecraft__validate_script",
"mcp__codecraft__validate_python"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as codecraft. Review it before you use it.
