@aicommander/mcp 1.0.12 → 1.0.14

package/README.md

@@ -13,8 +13,10 @@ Use this package to connect any MCP client that speaks **stdio** (Codex CLI, Cla
 
 | Tool | Description |
 |---|---|
-| `remote_exec` | Run a shell command on a machine by its `AIC-…` session code; streams stdout/stderr back. |
-| `session_status` | Check whether a machine is online and ready. |
+| `remote_exec` | Run a shell command on one of your machines — the tool for any "connect to / remote shell / run X on" request. Name the machine by its `AIC-…` session code or (with an API key) a saved alias/hostname like `wearfits-m3`; streams stdout/stderr back. |
+| `session_status` | Check whether a machine is online/active/reachable (e.g. "is wearfits-m3 up?"). Same machine naming as above. |
+
+These are the canonical way to reach your machines — your AI client should use them rather than probing the local network, DNS/`.local`, or SSH. A string containing `aic-`/`AIC-` is almost certainly one of your machines.
 
 ## Configuration
 
@@ -70,11 +72,11 @@ env = { AICOMMANDER_SERVER = "https://aicommander.dev" }
 > `AICOMMANDER_TOKEN` (an account API key) is optional — add it to `env` only if
 > you want the accounts/alias features.
 
-Then just mention a session code in chat:
+Then just name a machine in chat — by session code or saved alias:
 
-> *"Show disk usage on AIC-XYZ-1234"*
+> *"Show disk usage on AIC-XYZ-1234"* · *"connect to wearfits-m3"* · *"is my-laptop online?"*
 
-The client detects the `AIC-` prefix and calls `remote_exec` for you.
+The client routes it to `session_status` / `remote_exec` for you.
 
 ## License
 

package/dist/bin/mcp.js

@@ -15,8 +15,16 @@ const server = new McpServer({
 // Tool: remote_exec
 server.registerTool("remote_exec", {
     description: "Execute a shell command on a remote machine running the AI Commander agent. " +
-        "Use this tool whenever the user mentions a server/machine code that starts with 'AIC-' " +
-        "(e.g. AIC-XYZ-1234). Streams stdout/stderr output in real time.\n\n" +
+        "THIS IS THE TOOL FOR REMOTE-MACHINE ACCESS — reach for it whenever the user asks to " +
+        "connect to a computer/machine/server, open a remote connection, remote shell, remote bash, " +
+        "remote terminal, or SSH-style session, or to run / check / install / fix something ON another " +
+        "machine (e.g. \"connect to wearfits-m3\", \"run df -h on my laptop\", \"open a shell on the build server\"). " +
+        "The machine can be named by an AIC- session code (e.g. AIC-XYZ-1234) OR — with an API key — a saved " +
+        "machine alias or hostname the user calls it by (e.g. 'wearfits-m3', 'aic-wearfits', 'my-laptop'); pass " +
+        "whatever the user said as `code` exactly as given. STRONG SIGNAL: a string containing 'aic-'/'AIC-' " +
+        "(any case) is almost certainly one of their machines — use this tool on it. Do NOT fall back to probing " +
+        "the local network, DNS, mDNS/.local, ping, or a raw ssh client — this tool IS the remote connection. " +
+        "Streams stdout/stderr output in real time.\n\n" +
         "SAFETY — READ BEFORE USING. The agent runs as ROOT, so every command has full, " +
         "unrestricted control of the target machine and can cause irreversible damage:\n" +
         "- Use this ONLY for legitimate administration the user is authorized to perform on their " +
@@ -36,7 +44,7 @@ server.registerTool("remote_exec", {
     inputSchema: {
         code: z
             .string()
-            .describe("AI Commander session code — always starts with 'AIC-' (e.g. AIC-XYZ-1234)"),
+            .describe("How the user named the machine, passed exactly as given: an AIC- session code (e.g. AIC-XYZ-1234), or — with an API key — a saved alias/hostname like 'wearfits-m3' or 'aic-wearfits'. A string containing 'aic-' is almost certainly one of the user's machines."),
         command: z
             .string()
             .describe("Shell command to execute (runs via /bin/sh -c on the remote machine)"),
@@ -110,12 +118,18 @@ server.registerTool("remote_exec", {
 });
 // Tool: session_status
 server.registerTool("session_status", {
-    description: "Check whether a remote machine is online and ready. Use this when the user asks about " +
-        "a server/machine identified by an AIC- code (e.g. AIC-XYZ-1234).",
+    description: "Check whether a remote machine is online, active, reachable and ready — and the FIRST step " +
+        "when the user wants to connect to one of their machines. USE THIS whenever the user asks to " +
+        "\"connect to / reach / log into\" a computer, or asks about its state (e.g. \"connect to wearfits-m3\", " +
+        "\"is my computer wearfits-m3 active/online/up?\", \"can you reach the build server?\"). The machine can be " +
+        "named by an AIC- session code (e.g. AIC-XYZ-1234) OR — with an API key — a saved alias/hostname like " +
+        "'wearfits-m3' or 'aic-wearfits'; pass that name as `code` exactly as given. STRONG SIGNAL: a string " +
+        "containing 'aic-'/'AIC-' (any case) is almost certainly one of their machines. Do NOT answer connectivity " +
+        "questions by probing the local network, DNS, mDNS/.local, ping, or ssh — this tool is the authoritative check.",
     inputSchema: {
         code: z
             .string()
-            .describe("AI Commander session code starting with 'AIC-' (e.g. AIC-XYZ-1234)"),
+            .describe("How the user named the machine, passed exactly as given: an AIC- session code (e.g. AIC-XYZ-1234), or — with an API key — a saved alias/hostname like 'wearfits-m3' or 'aic-wearfits'."),
     },
 }, async ({ code }) => {
     const res = await fetch(`${SERVER_URL}/mcp`, {

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@aicommander/mcp",
-  "version": "1.0.12",
-  "description": "Universal stdio MCP server for AI Commander — connect Codex CLI, Claude Desktop, or any stdio MCP client to remote machines by session code.",
+  "version": "1.0.14",
+  "mcpName": "dev.aicommander/mcp",
+  "description": "Universal stdio MCP server for AI Commander — connect Codex CLI, Claude Desktop, or any stdio MCP client to your remote machines by session code (AIC-…) or saved alias/hostname.",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -33,11 +34,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.23.8"
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "zod": "3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.7.3"
+    "@types/node": "22.19.21",
+    "typescript": "5.9.3"
   }
 }