@aicommander/mcp 1.0.0 → 1.0.2

package/README.md

@@ -5,7 +5,7 @@ Universal **stdio MCP server** for [AI Commander](https://aicommander.dev) — r
 Use this package to connect any MCP client that speaks **stdio** (Codex CLI, Claude Desktop's config file, Cursor, Windsurp, …) to your AI Commander relay. It wraps the remote HTTPS/SSE MCP endpoint so clients that can only launch a local process get the same `remote_exec` and `session_status` tools.
 
 > Using **Claude Code**? You don't need this package — add the relay directly:
-> `claude mcp add --transport http aicommander https://<your-worker>/mcp --header "Authorization: Bearer <token>"`
+> `claude mcp add --transport http aicommander https://aicommander.dev/mcp --header "Authorization: Bearer <token>"`
 
 ## Tools
 
@@ -21,7 +21,7 @@ Two environment variables:
 | Variable | Required | Default | Description |
 |---|---|---|---|
 | `AICOMMANDER_ADMIN_TOKEN` | **yes** | — | Admin token from `POST /api/admin/token` on your relay. |
-| `AICOMMANDER_SERVER` | no | `https://aic-worker.lrz.workers.dev` | Base URL of your self-hosted AI Commander Worker. |
+| `AICOMMANDER_SERVER` | no | `https://aicommander.dev` | Base URL of your self-hosted AI Commander Worker. |
 
 ## Usage
 
@@ -31,7 +31,7 @@ Two environment variables:
 [mcp_servers.aicommander]
 command = "npx"
 args = ["-y", "@aicommander/mcp"]
-env = { AICOMMANDER_ADMIN_TOKEN = "<token>", AICOMMANDER_SERVER = "https://<your-worker>" }
+env = { AICOMMANDER_ADMIN_TOKEN = "<token>", AICOMMANDER_SERVER = "https://aicommander.dev" }
 ```
 
 ### Claude Desktop — `claude_desktop_config.json`
@@ -44,7 +44,7 @@ env = { AICOMMANDER_ADMIN_TOKEN = "<token>", AICOMMANDER_SERVER = "https://<your
       "args": ["-y", "@aicommander/mcp"],
       "env": {
         "AICOMMANDER_ADMIN_TOKEN": "<token>",
-        "AICOMMANDER_SERVER": "https://<your-worker>"
+        "AICOMMANDER_SERVER": "https://aicommander.dev"
       }
     }
   }
@@ -53,7 +53,7 @@ env = { AICOMMANDER_ADMIN_TOKEN = "<token>", AICOMMANDER_SERVER = "https://<your
 
 Then just mention a session code in chat:
 
-> *"Show disk usage on AIC-WOLF-7421"*
+> *"Show disk usage on AIC-XYZ-1234"*
 
 The client detects the `AIC-` prefix and calls `remote_exec` for you.
 

package/dist/bin/mcp.js

@@ -2,12 +2,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-const SERVER_URL = process.env["AICOMMANDER_SERVER"] ?? "https://aic-worker.lrz.workers.dev";
+const SERVER_URL = process.env["AICOMMANDER_SERVER"] ?? "https://aicommander.dev";
+// Optional. If set, it logs into your AI Commander account (stage 2 — saved
+// machines, aliases, API keys). Without it the bridge works anonymously and you
+// drive machines by their session code (AIC-…).
 const ADMIN_TOKEN = process.env["AICOMMANDER_ADMIN_TOKEN"];
-if (!ADMIN_TOKEN) {
-    process.stderr.write("Error: AICOMMANDER_ADMIN_TOKEN environment variable is required\n");
-    process.exit(1);
-}
 const server = new McpServer({
     name: "aicommander",
     version: "1.0.0",
@@ -16,11 +15,11 @@ const server = new McpServer({
 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-WOLF-7421). Streams stdout/stderr output in real time.",
+        "(e.g. AIC-XYZ-1234). Streams stdout/stderr output in real time.",
     inputSchema: {
         code: z
             .string()
-            .describe("AI Commander session code — always starts with 'AIC-' (e.g. AIC-WOLF-7421)"),
+            .describe("AI Commander session code — always starts with 'AIC-' (e.g. AIC-XYZ-1234)"),
         command: z
             .string()
             .describe("Shell command to execute (runs via /bin/sh -c on the remote machine)"),
@@ -38,7 +37,7 @@ server.registerTool("remote_exec", {
         method: "POST",
         headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${ADMIN_TOKEN}`,
+            ...(ADMIN_TOKEN ? { Authorization: `Bearer ${ADMIN_TOKEN}` } : {}),
             Accept: "text/event-stream",
         },
         body: JSON.stringify({
@@ -95,18 +94,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-WOLF-7421).",
+        "a server/machine identified by an AIC- code (e.g. AIC-XYZ-1234).",
     inputSchema: {
         code: z
             .string()
-            .describe("AI Commander session code starting with 'AIC-' (e.g. AIC-WOLF-7421)"),
+            .describe("AI Commander session code starting with 'AIC-' (e.g. AIC-XYZ-1234)"),
     },
 }, async ({ code }) => {
     const res = await fetch(`${SERVER_URL}/mcp`, {
         method: "POST",
         headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${ADMIN_TOKEN}`,
+            ...(ADMIN_TOKEN ? { Authorization: `Bearer ${ADMIN_TOKEN}` } : {}),
         },
         body: JSON.stringify({
             jsonrpc: "2.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicommander/mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Universal stdio MCP server for AI Commander — connect Codex CLI, Claude Desktop, or any stdio MCP client to remote machines by session code.",
   "keywords": [
     "mcp",