miniantgames-mcp 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miniant Labs Limited, trading as Miniant Games (https://www.miniant.games)
+
+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

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# miniantgames-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A local [MCP](https://modelcontextprotocol.io) server that helps your AI coding agent build games
+for [Miniant Games](https://www.miniant.games). It gives the agent the developer guide, the
+publishing checklists, the build validator and a starter game, all offline.
+
+Publishing itself still happens at [publish.miniant.games](https://publish.miniant.games).
+
+## Install
+
+Claude Code:
+
+```bash
+claude mcp add miniantgames -- npx -y miniantgames-mcp
+```
+
+Any other MCP client (Claude Desktop, Cursor, and so on):
+
+```json
+{
+  "mcpServers": {
+    "miniantgames": { "command": "npx", "args": ["-y", "miniantgames-mcp"] }
+  }
+}
+```
+
+Requires Node.js 20 or later. Paths passed to the tools resolve against the folder the client
+starts the server in, normally your game's project folder.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `list_guide` | Every guide page with a one-line summary, plus the task recipes |
+| `read_guide` | One guide page as markdown, with its checklist (`agent-entry` for the rules) |
+| `search_guide` | Find which page documents an SDK call or rule |
+| `get_checklist` | Requirements for one page, or for a whole recipe such as `publish-new-game` |
+| `validate_build` | Run the same validator the publishing pipeline runs on your build folder |
+| `scaffold_game` | Write a plain-JavaScript starter game into a new or empty folder |
+
+`scaffold_game` is the only tool that writes files, and it never overwrites a non-empty folder.
+
+## Try it
+
+Ask your agent: "Use the miniantgames tools to start a solo game in `./my-game`, then validate it."
+
+## License
+
+MIT

package/bin/miniantgames-mcp.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// Committed launcher: `bin` points here, not at dist/, because dist/ is gitignored build output
+// that does not exist when `pnpm install` links workspace bins (same reason as
+// packages/game-sdk/bin/miniant-validate.mjs). The missing-build case is reported at run time.
+
+const distUrl = new URL("../dist/index.js", import.meta.url);
+
+let mod;
+try {
+  mod = await import(distUrl.href);
+} catch (error) {
+  console.error(
+    "miniantgames-mcp: could not load dist/index.js. If you are in the monorepo, run\n" +
+      "`pnpm --filter miniantgames-mcp build` first.\n" +
+      (error instanceof Error ? error.message : String(error)),
+  );
+  process.exit(1);
+}
+
+await mod.main();