@lzimul/minecraft-mcp 1.0.1 → 1.0.3

package/README.md

@@ -12,6 +12,20 @@ Minecraft Model Context Protocol (MCP) server. It exposes the complete Minecraft
 - Every failure path returns a readable message instead of an unhandled exception
 - Tool annotations for safe client automation
 
+## Protocol
+
+This server implements **MCP 2026-07-28 only**. The legacy 2025-era `initialize` handshake is rejected, so clients must use the modern protocol:
+
+- Start a session with `server/discover`, or send any request carrying the per-request envelope.
+- Every request must include the envelope in `params._meta`:
+  - `io.modelcontextprotocol/protocolVersion`: `"2026-07-28"`
+  - `io.modelcontextprotocol/clientCapabilities`
+  - `io.modelcontextprotocol/clientInfo` (optional)
+- Responses use the modern result shape (`resultType`, server identity under `_meta['io.modelcontextprotocol/serverInfo']`).
+- A legacy `initialize` is answered with `UnsupportedProtocolVersionError` naming the supported modern revision.
+
+When testing with MCP Inspector 2.12 or newer, set **Protocol Era** to `modern` (or `auto`) for this server. The Inspector's default `legacy` mode sends `initialize`, which this server intentionally rejects.
+
 ## Tools
 
 | Tool       | Description                                                                            |
@@ -130,6 +144,7 @@ src/
 scripts/
   generate-data.mjs        Regenerates src/data from minecraft-data
   smoke-test.mjs           End-to-end smoke test (including states)
+  protocol-test.mjs        Modern-only protocol era and envelope enforcement
   persistence-test.mjs     Restart test for the world snapshots
   error-test.mjs           Error fallbacks, sanitizing and storage limit tests
   stress-test.mjs          Parallel write, coalescing and restart stress test
@@ -138,16 +153,16 @@ scripts/
 
 ## Scripts
 
-| Command                 | Description                                           |
-| ----------------------- | ----------------------------------------------------- |
-| `npm run build`         | Lint, compile and generate docs                       |
-| `npm run dev`           | Build then start the server                           |
-| `npm start`             | Start the server (stdio)                              |
-| `npm test`              | Run the smoke, persistence, security and stress tests |
-| `npm run test:stress`   | Run only the parallel write stress test               |
-| `npm run generate-data` | Regenerate registry data (see below)                  |
-| `npm run clean`         | Remove build output                                   |
-| `npm run lint`          | Lint and auto-fix                                     |
+| Command                 | Description                                                     |
+| ----------------------- | --------------------------------------------------------------- |
+| `npm run build`         | Lint, compile and generate docs                                 |
+| `npm run dev`           | Build then start the server                                     |
+| `npm start`             | Start the server (stdio)                                        |
+| `npm test`              | Run the smoke, protocol, persistence, security and stress tests |
+| `npm run test:stress`   | Run only the parallel write stress test                         |
+| `npm run generate-data` | Regenerate registry data (see below)                            |
+| `npm run clean`         | Remove build output                                             |
+| `npm run lint`          | Lint and auto-fix                                               |
 
 ## Data
 

package/build/config/server-info.js

@@ -6,7 +6,7 @@ export const SERVER_INFO = {
     name: 'lzimul',
     title: 'lZiMUl Minecraft MCP',
     description: `Minecraft Model Context Protocol server (Java Edition ${MINECRAFT_DATA_VERSION}): exposes all ${MINECRAFT_BLOCK_COUNT} blocks and ${MINECRAFT_ITEM_COUNT} items with their properties (name, hardness, blast resistance, durability, enchantment categories, etc.) as resources, plus tools to get and place blocks and look up items.`,
-    version: '1.0.1',
+    version: '1.0.3',
     websiteUrl: 'https://mcp.lzimul.com/lZiMUl',
     icons: [
         {

package/build/index.js

@@ -7,7 +7,9 @@ import { createWorldStore } from './world/stores/index.js';
 import { World } from './world/world.js';
 async function main() {
     const world = await World.load(createWorldStore(), WORLD_STORAGE.writeDelayMs);
-    const handle = serveStdio(() => createServer(world));
+    const handle = serveStdio(() => createServer(world), {
+        legacy: 'reject'
+    });
     let shuttingDown = false;
     const shutdown = async (exitCode) => {
         if (shuttingDown) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lzimul/minecraft-mcp",
   "description": "Minecraft Model Context Protocol (MCP) Server",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "author": {
     "name": "lZiMUl",
     "email": "lZiMUl@lzimul.com",
@@ -43,7 +43,7 @@
     "dev": "npm run build && npm run start",
     "generate-data": "node ./scripts/generate-data.mjs",
     "clean": "node ./scripts/clean.mjs",
-    "test": "node ./scripts/smoke-test.mjs && node ./scripts/persistence-test.mjs && node ./scripts/error-test.mjs && node ./scripts/stress-test.mjs",
+    "test": "node ./scripts/smoke-test.mjs && node ./scripts/protocol-test.mjs && node ./scripts/persistence-test.mjs && node ./scripts/error-test.mjs && node ./scripts/stress-test.mjs",
     "test:stress": "node ./scripts/stress-test.mjs"
   },
   "files": [
@@ -61,34 +61,34 @@
     "minecraft-mcp"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   },
   "overrides": {
     "katex": "^0.19.1"
   },
   "dependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
-    "zod": "^4.6.5"
+    "@modelcontextprotocol/server": "^2.4.0",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@eslint/css": "^2.0.0",
+    "@eslint/css": "^2.0.1",
     "@eslint/eslintrc": "^3.3.7",
     "@eslint/js": "^10.0.1",
-    "@eslint/json": "^2.1.0",
+    "@eslint/json": "^2.1.1",
     "@eslint/markdown": "^8.0.3",
-    "@types/node": "^26.6.1",
-    "@typescript-eslint/eslint-plugin": "^8.70.0",
-    "@typescript-eslint/parser": "^8.70.0",
-    "eslint": "^10.10.0",
+    "@types/node": "^26.6.5",
+    "@typescript-eslint/eslint-plugin": "^8.72.0",
+    "@typescript-eslint/parser": "^8.72.0",
+    "eslint": "^10.13.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.6",
-    "globals": "^17.12.0",
+    "eslint-plugin-prettier": "^5.5.7",
+    "globals": "^17.13.0",
     "jiti": "^2.7.0",
-    "prettier": "^3.9.8",
+    "prettier": "^3.9.10",
     "tslib": "^2.8.1",
     "typedoc": "^0.28.20",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.0"
+    "typescript-eslint": "^8.72.0"
   },
   "repository": {
     "type": "git",
@@ -106,4 +106,4 @@
   },
   "sideEffects": false,
   "private": false
-}
+}