@nodegx/mcp 0.2.5 → 0.2.7

package/README.md

@@ -11,8 +11,8 @@ and the validator's feedback — never the entire project.*
 
 ## Install
 
-The simplest start is `npm create nodegx my-apps`. It writes one file, `my-apps/.mcp.json`. That file tells Claude Code
-to start this server when you run `claude` in the folder.
+The simplest start is `npm create nodegx my-apps`. It writes `my-apps/.mcp.json`, which tells Claude Code to start this
+server when you run `claude` in the folder, beside short `CLAUDE.md` / `AGENTS.md` notes and the NodeGX skills.
 
 Any other MCP client can start the server itself over stdio:
 
@@ -78,13 +78,15 @@ Drop `--allow-writes` for a read-only server.
 claude mcp add --scope user nodegx-bootstrap -- node <path-to>/noodl-mcp.cjs --allow-writes
 ```
 
-Omit the project directory and the server starts anyway, advertising four tools:
+Omit the project directory and the server starts anyway, advertising seven tools:
 
 | Tool | |
 |---|---|
 | `list_projects` | The NodeGX projects this machine has opened, read from the launcher's own recent-projects list and never written to. **Call this first** when the user talks about their app as something that already exists |
+| `open_project` | Bind this server to a project `list_projects` reported; its tools arrive in the same conversation |
 | `create_project` | Scope an app in conversation, then write the project, its `docs/` and a build plan that is returned but not run |
 | `list_examples`, `get_example` | What a NodeGX graph actually looks like, without needing a project to read |
+| `find_tools`, `call_tool` | Find a tool that is not advertised yet, or call one by name (for a client that does not refresh its tool list) |
 
 Everything else — reading components, authoring, validation, rendering, the backend — is **absent
 from `tools/list`**, not present-and-erroring, because a model calls what it is shown.
@@ -93,9 +95,9 @@ from `tools/list`**, not present-and-erroring, because a model calls what it is
 `create_project` is a write, and with no project there is nothing to read, so a read-only bootstrap
 server would start, appear connected, and be unable to do the one thing it exists for.
 
-⚠️ **Creating a project does not repoint this server.** The project is written to disk and the
-server stays unbound; register a second server against the new directory to author in it. (BST-002
-is the task that makes the live server bind itself.)
+**Creating or opening a project binds this server to it.** Its tools arrive in the same conversation
+(`notifications/tools/list_changed`), with no second registration and no restart. A server binds once: a second
+`create_project` or `open_project` leaves it on the first project, and says so.
 
 ### Where the bundle is
 
@@ -299,7 +301,8 @@ npm run build --workspace @nodegx/mcp   # esbuild → dist/noodl-mcp.cjs
 
 - File-based only; no live sync with a running editor (a bridge is future work —
   the editor holds its own in-memory state and can overwrite MCP writes on save).
-- No project-level settings/styles/routes writes, asset upload, or model files in v1.
+- No asset upload or model files. Project settings, tokens and element styles are written by `set_project_settings`,
+  `set_project_tokens` and `set_element_style`; a page is registered in the router when it is written.
 - Read-side supports v2 directories only; migrate legacy projects with the editor first.
 - `get_node_type` with several types can exceed an MCP host's tool-result cap
   (~126 KB for 7 types in the SUB-010 demo, and the host's "overflow saved to a
@@ -310,3 +313,7 @@ npm run build --workspace @nodegx/mcp   # esbuild → dist/noodl-mcp.cjs
 
 The server is licensed GPL-3.0-only because it bundles code from the NodeGX editor. The source is in
 [The-Low-Code-Foundation/NodeGX](https://github.com/The-Low-Code-Foundation/NodeGX), under `packages/noodl-mcp`.
+
+The apps it builds aren't under the GPL. Their pages, data and assets belong to whoever built them. A deployed
+app runs on the NodeGX runtime, which is MIT, and on the backend in `dist/backend/`, which is MIT too and carries its
+own `LICENSE`. Every deployed folder holds a `NODEGX-LICENSE.txt` that says which licence covers which file.

package/bin/noodl-mcp.js

@@ -1,2 +1,16 @@
 #!/usr/bin/env node
+// P125 CCN-001 s5 (2026-10-23) — the bundle needs Node 20 or newer (`@nodegx/node-spec` wants the `File`
+// constructor). Claude Desktop starts a SECOND copy of a server "for Cowork and Code sessions" from a shared pool
+// with its own, shorter PATH, where `node` resolved to v16 on Richard's Mac while the chat's copy got v22: that
+// copy died with a stack trace at the top of mcp-server-nodegx.log and Desktop said "nodegx couldn't start". Said
+// in one sentence, with the fix, before the require that would throw it.
+var major = Number(process.versions.node.split('.')[0]);
+if (major < 20) {
+  process.stderr.write(
+    'noodl-mcp: needs Node 20 or newer; this is Node ' + process.versions.node + ' at ' + process.execPath + '. ' +
+      'In the host\'s config, set "command" to an absolute path of a newer node (for nvm: ~/.nvm/versions/node/v22.x/bin/node) ' +
+      'rather than "node": a host can start a server with a PATH that is not your shell\'s.\n'
+  );
+  process.exit(1);
+}
 require('../dist/noodl-mcp.cjs');

package/dist/backend/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) The NodeGX contributors
+
+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.