minecraft-mcp-rs 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 halfoffive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# minecraft-mcp-rs
+
+MCP server that controls a Minecraft bot (azalea) — prebuilt native binaries.
+
+## Usage
+
+```bash
+npx minecraft-mcp-rs --headless --stdio
+```
+
+or install globally:
+
+```bash
+npm install -g minecraft-mcp-rs
+minecraft-mcp-rs --headless --stdio
+```
+
+For Claude Desktop / Cursor, add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "minecraft": {
+      "command": "npx",
+      "args": ["-y", "minecraft-mcp-rs", "--headless", "--stdio"]
+    }
+  }
+}
+```
+
+See the [root README](https://github.com/halfoffive/minecraft-mcp-rs#readme) for
+the full documentation (config file, MCP tools, CLI flags).
+
+## Platform packages
+
+The main package is a thin launcher; the native binary ships in one of five
+platform packages selected automatically at install time:
+
+| Package | Platform |
+| --- | --- |
+| `minecraft-mcp-rs-windows-x64` | Windows x64 |
+| `minecraft-mcp-rs-windows-arm64` | Windows arm64 |
+| `minecraft-mcp-rs-darwin-arm64` | macOS arm64 |
+| `minecraft-mcp-rs-linux-x64` | Linux x64 |
+| `minecraft-mcp-rs-linux-arm64` | Linux arm64 |
+
+Installing with `--omit=optional` breaks the launcher; reinstall the matching
+platform package explicitly to fix it.

package/bin/minecraft-mcp-rs.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+"use strict";
+
+// minecraft-mcp-rs — platform-package launcher shim.
+//
+// The main npm package is platform-independent; the actual native binary
+// lives in one of five optional platform packages (see `optionalDependencies`
+// in package.json). This shim resolves the platform package for the current
+// process.platform/process.arch, locates the binary inside it, and execs it,
+// forwarding all CLI arguments.
+//
+// If the platform package is missing (e.g. the user installed with
+// `--omit=optional` or on an unsupported platform), we print a helpful error
+// and exit 1 instead of crashing with an unhelpful stack trace.
+
+const { spawnSync } = require("node:child_process");
+
+// Map of `${process.platform}-${process.arch}` to [packageName, binaryName].
+// The binary names match what the CI npm-publish job stages into each
+// platform package (see .github/workflows/release.yml).
+const PLATFORMS = {
+  "win32-x64": ["@minecraft-mcp-rs/minecraft-mcp-rs-windows-x64", "minecraft-mcp-rs.exe"],
+  "win32-arm64": ["@minecraft-mcp-rs/minecraft-mcp-rs-windows-arm64", "minecraft-mcp-rs.exe"],
+  "darwin-arm64": ["@minecraft-mcp-rs/minecraft-mcp-rs-darwin-arm64", "minecraft-mcp-rs"],
+  "linux-x64": ["@minecraft-mcp-rs/minecraft-mcp-rs-linux-x64", "minecraft-mcp-rs"],
+  "linux-arm64": ["@minecraft-mcp-rs/minecraft-mcp-rs-linux-arm64", "minecraft-mcp-rs"],
+};
+
+const platformKey = `${process.platform}-${process.arch}`;
+const entry = PLATFORMS[platformKey];
+
+if (!entry) {
+  console.error(
+    `minecraft-mcp-rs does not support ${process.platform} (${process.arch}).\n` +
+      `Supported platforms: ${Object.keys(PLATFORMS).join(", ")}.`
+  );
+  process.exit(1);
+}
+
+const [pkgName, binaryName] = entry;
+
+let binPath;
+try {
+  // resolve() throws if the platform package is not installed.
+  binPath = require.resolve(`${pkgName}/${binaryName}`);
+} catch {
+  console.error(
+    `The ${pkgName} platform package is missing (expected binary: ${binaryName}).\n` +
+      `This usually means npm did not install optional dependencies:\n` +
+      `  - did you use \`npm install --omit=optional\`? That breaks the platform packages.\n` +
+      `  - reinstall with: npm install ${pkgName}\n` +
+      `  - or reinstall the main package with --force to re-fetch optional deps.`
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "minecraft-mcp-rs",
+  "version": "1.1.1",
+  "description": "MCP server that controls a Minecraft bot (azalea) — prebuilt binaries",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/halfoffive/minecraft-mcp-rs.git"
+  },
+  "homepage": "https://github.com/halfoffive/minecraft-mcp-rs#readme",
+  "bin": {
+    "minecraft-mcp-rs": "bin/minecraft-mcp-rs.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@minecraft-mcp-rs/minecraft-mcp-rs-windows-x64": "1.1.0",
+    "@minecraft-mcp-rs/minecraft-mcp-rs-windows-arm64": "1.1.0",
+    "@minecraft-mcp-rs/minecraft-mcp-rs-darwin-arm64": "1.1.0",
+    "@minecraft-mcp-rs/minecraft-mcp-rs-linux-x64": "1.1.0",
+    "@minecraft-mcp-rs/minecraft-mcp-rs-linux-arm64": "1.1.0"
+  }
+}