nova-control-mcp-server 0.0.1 → 0.0.3

package/README.md

@@ -12,12 +12,20 @@ An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server for co
 
 ## Installation
 
+**No install — run directly with `npx`** (recommended for MCP clients):
+
 ```bash
-npm install
-npm run build
+npx nova-control-mcp-server --port /dev/ttyACM0
 ```
 
-The compiled binary lands at `dist/nova-control-mcp-server.js`.
+`npx` downloads the package on first use and caches it locally. This is the simplest way to use the server and requires no global installation.
+
+**Global install:**
+
+```bash
+npm install -g nova-control-mcp-server
+nova-control-mcp-server --port /dev/ttyACM0
+```
 
 ## Configuration
 
@@ -29,12 +37,21 @@ Add the server to `~/Library/Application Support/Claude/claude_desktop_config.js
 {
   "mcpServers": {
     "nova-control": {
-      "command": "node",
-      "args": [
-        "/absolute/path/to/nova-control-mcp-server/dist/nova-control-mcp-server.js",
-        "--port", "/dev/ttyACM0",
-        "--baud", "115200"
-      ]
+      "command": "npx",
+      "args": ["nova-control-mcp-server", "--port", "/dev/ttyACM0"]
+    }
+  }
+}
+```
+
+With a custom baud rate:
+
+```json
+{
+  "mcpServers": {
+    "nova-control": {
+      "command": "npx",
+      "args": ["nova-control-mcp-server", "--port", "/dev/ttyACM0", "--baud", "115200"]
     }
   }
 }

package/dist/nova-control-mcp-server.js

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
 import { fileURLToPath as e } from "node:url";
-import { parseArgs as t } from "node:util";
-import { Server as n } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport as r } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema as i, ListToolsRequestSchema as a } from "@modelcontextprotocol/sdk/types.js";
-import { openNova as o } from "nova-control-node";
+import { realpathSync as t } from "node:fs";
+import { parseArgs as n } from "node:util";
+import { Server as r } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport as i } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema as a, ListToolsRequestSchema as o } from "@modelcontextprotocol/sdk/types.js";
+import { openNova as s } from "nova-control-node";
 //#region src/nova-control-mcp-server.ts
-function s() {
+function c() {
 	try {
-		let { values: e } = t({
+		let { values: e } = n({
 			args: process.argv.slice(2),
 			options: {
 				port: {
@@ -31,20 +32,20 @@ function s() {
 		process.stderr.write(`nova-control-mcp: ${e.message ?? e}\n`), process.exit(1);
 	}
 }
-var c = "", l = 9600, u;
-async function d() {
-	return u ??= await o(c, l), u;
+var l = "", u = 9600, d;
+async function f() {
+	return d ??= await s(l, u), d;
 }
-function f() {
-	u != null && (u.destroy(), u = void 0);
+function p() {
+	d != null && (d.destroy(), d = void 0);
 }
-function p(e, t = 9600) {
-	c = e, l = t;
+function m(e, t = 9600) {
+	l = e, u = t;
 }
-function m() {
-	f(), c = "", l = 9600;
+function h() {
+	p(), l = "", u = 9600;
 }
-var h = [
+var g = [
 	{
 		name: "home",
 		description: "send all servos to their home positions",
@@ -163,80 +164,80 @@ var h = [
 		}
 	}
 ];
-async function g() {
-	return await (await d()).home(), "all servos moved to home positions";
+async function _() {
+	return await (await f()).home(), "all servos moved to home positions";
 }
-async function _(e) {
+async function v(e) {
 	let t = {};
 	if (e.shift_to != null && (t.s1 = Number(e.shift_to)), e.roll_to != null && (t.s2 = Number(e.roll_to)), e.pitch_to != null && (t.s3 = Number(e.pitch_to)), e.rotate_to != null && (t.s4 = Number(e.rotate_to)), e.lift_to != null && (t.s5 = Number(e.lift_to)), Object.keys(t).length === 0) throw Error("move: at least one of shift_to, roll_to, pitch_to, rotate_to, lift_to is required");
-	let n = await d();
+	let n = await f();
 	return n.State = t, await n.sendServoState(), `servos updated: ${JSON.stringify(t)}`;
 }
-async function v(e) {
-	let t = Number(e.deg), n = await d();
+async function y(e) {
+	let t = Number(e.deg), n = await f();
 	return n.State = { s1: t }, await n.sendServoState(), `s1 (shift) → ${t}°`;
 }
-async function y(e) {
-	let t = Number(e.deg), n = await d();
+async function b(e) {
+	let t = Number(e.deg), n = await f();
 	return n.State = { s2: t }, await n.sendServoState(), `s2 (roll) → ${t}°`;
 }
-async function b(e) {
-	let t = Number(e.deg), n = await d();
+async function x(e) {
+	let t = Number(e.deg), n = await f();
 	return n.State = { s3: t }, await n.sendServoState(), `s3 (pitch) → ${t}°`;
 }
-async function x(e) {
-	let t = Number(e.deg), n = await d();
+async function S(e) {
+	let t = Number(e.deg), n = await f();
 	return n.State = { s4: t }, await n.sendServoState(), `s4 (rotate) → ${t}°`;
 }
-async function S(e) {
-	let t = Number(e.deg), n = await d();
+async function C(e) {
+	let t = Number(e.deg), n = await f();
 	return n.State = { s5: t }, await n.sendServoState(), `s5 (lift) → ${t}°`;
 }
-async function C(e) {
+async function w(e) {
 	let t = Number(e.ms);
 	if (isNaN(t) || t < 0) throw Error(`wait: invalid duration '${e.ms}' — expected a non-negative number`);
 	return await new Promise((e) => setTimeout(e, t)), `waited ${t} ms`;
 }
-async function w() {
-	let e = await d();
+async function T() {
+	let e = await f();
 	return JSON.stringify(e.State);
 }
-function T() {
-	let e = new n({
+function E() {
+	let e = new r({
 		name: "nova-control-mcp-server",
 		version: "0.0.1"
 	}, { capabilities: { tools: {} } });
-	return e.setRequestHandler(a, async () => ({ tools: h })), e.setRequestHandler(i, async (e) => {
+	return e.setRequestHandler(o, async () => ({ tools: g })), e.setRequestHandler(a, async (e) => {
 		let t = e.params.name, n = e.params.arguments ?? {};
 		try {
 			let e;
 			switch (t) {
 				case "home":
-					e = await g();
+					e = await _();
 					break;
 				case "move":
-					e = await _(n);
+					e = await v(n);
 					break;
 				case "shift_to":
-					e = await v(n);
+					e = await y(n);
 					break;
 				case "roll_to":
-					e = await y(n);
+					e = await b(n);
 					break;
 				case "pitch_to":
-					e = await b(n);
+					e = await x(n);
 					break;
 				case "rotate_to":
-					e = await x(n);
+					e = await S(n);
 					break;
 				case "lift_to":
-					e = await S(n);
+					e = await C(n);
 					break;
 				case "wait":
-					e = await C(n);
+					e = await w(n);
 					break;
 				case "get_state":
-					e = await w();
+					e = await T();
 					break;
 				default: return {
 					content: [{
@@ -261,17 +262,17 @@ function T() {
 		}
 	}), e;
 }
-async function E() {
-	let { Port: e, BaudRate: t } = s();
-	c = e, l = t;
-	let n = T(), i = new r();
-	await n.connect(i);
+async function D() {
+	let { Port: e, BaudRate: t } = c();
+	l = e, u = t;
+	let n = E(), r = new i();
+	await n.connect(r);
 	for (let e of ["SIGINT", "SIGTERM"]) process.on(e, () => {
-		f(), process.exit(0);
+		p(), process.exit(0);
 	});
 }
-process.argv[1] === e(import.meta.url) && E().catch((e) => {
+t(process.argv[1]) === e(import.meta.url) && D().catch((e) => {
 	process.stderr.write(`nova-control-mcp: fatal: ${e.message ?? e}\n`), process.exit(1);
 });
 //#endregion
-export { m as _destroyForTests, p as _setupForTests, T as createServer };
+export { h as _destroyForTests, m as _setupForTests, E as createServer };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nova-control-mcp-server",
   "description": "MCP server for controlling a NOVA DIY Artificial Intelligence Robot by Creoqode",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "keywords": [
     "nova",
@@ -22,7 +22,8 @@
   },
   "license": "MIT",
   "bin": {
-    "nova-control-mcp": "./dist/nova-control-mcp-server.js"
+    "nova-control-mcp": "./dist/nova-control-mcp-server.js",
+    "nova-control-mcp-server": "./dist/nova-control-mcp-server.js"
   },
   "files": [
     "dist"