weixin-mcp 1.3.1 → 1.3.2

package/dist/cli.js

@@ -43,7 +43,15 @@ else if (command === "logs") {
 }
 else if (command === "accounts") {
     const { manageAccounts } = await import("./accounts.js");
-    await manageAccounts(process.argv.slice(3)); // [subcommand, ...args]
+    await manageAccounts(process.argv.slice(3));
+}
+else if (command === "send") {
+    const { cliSend } = await import("./messaging.js");
+    await cliSend(process.argv.slice(3)); // <userId> <text...>
+}
+else if (command === "poll") {
+    const { cliPoll } = await import("./messaging.js");
+    await cliPoll(process.argv.slice(3)); // [--watch] [--reset]
 }
 else if (command === undefined || command === "serve") {
     // Default: stdio MCP server (for Claude Desktop integration)
@@ -62,6 +70,8 @@ Commands:
   stop                         Stop daemon
   restart                      Restart daemon
   logs [-f]                    Show daemon logs (-f to follow)
+  send <userId> <text>         Send a message from CLI
+  poll [--watch|-w] [--reset]  Poll messages once, or watch continuously
   accounts [list]              List all accounts
   accounts remove <id>         Remove an account
   accounts clean               Remove duplicate accounts (same userId), keep newest

package/dist/messaging.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI messaging commands:
+ *   npx weixin-mcp send <userId> <text>   — send a message
+ *   npx weixin-mcp poll [--watch] [--reset] — poll for messages (once or continuous)
+ */
+export declare function cliSend(args: string[]): Promise<void>;
+export declare function cliPoll(args: string[]): Promise<void>;

package/dist/messaging.js

@@ -0,0 +1,100 @@
+/**
+ * CLI messaging commands:
+ *   npx weixin-mcp send <userId> <text>   — send a message
+ *   npx weixin-mcp poll [--watch] [--reset] — poll for messages (once or continuous)
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { ACCOUNTS_DIR } from "./paths.js";
+import { DEFAULT_BASE_URL, sendTextMessage, getUpdates, loadCursor, saveCursor, } from "./api.js";
+function loadAccount() {
+    const files = fs.readdirSync(ACCOUNTS_DIR).filter((f) => f.endsWith(".json") && !f.endsWith(".sync.json") && !f.endsWith(".cursor.json"));
+    if (files.length === 0)
+        throw new Error("No account. Run: npx weixin-mcp login");
+    const accountId = process.env.WEIXIN_ACCOUNT_ID ?? files[0].replace(".json", "");
+    const data = JSON.parse(fs.readFileSync(path.join(ACCOUNTS_DIR, `${accountId}.json`), "utf-8"));
+    if (!data.token)
+        throw new Error(`No token for ${accountId}. Run: npx weixin-mcp login`);
+    return { ...data, accountId };
+}
+function formatMsg(msg) {
+    const from = String(msg.from_user_id ?? "?");
+    const items = msg.item_list ?? [];
+    const parts = [];
+    for (const item of items) {
+        if (item.type === 1 && item.text_item?.text)
+            parts.push(item.text_item.text);
+        else if (item.type === 2 && item.image_item?.url)
+            parts.push(`[image: ${item.image_item.url}]`);
+        else
+            parts.push(`[type:${item.type}]`);
+    }
+    const msgType = Number(msg.message_type);
+    const prefix = msgType === 1 ? "← " : "→ "; // incoming vs outgoing
+    return `${prefix}${from.slice(0, 20)}: ${parts.join(" ") || "(empty)"}`;
+}
+export async function cliSend(args) {
+    const [to, ...textParts] = args;
+    if (!to || textParts.length === 0) {
+        console.error("Usage: npx weixin-mcp send <userId> <message text>");
+        process.exit(1);
+    }
+    const text = textParts.join(" ");
+    const { token, baseUrl = DEFAULT_BASE_URL } = loadAccount();
+    process.stdout.write(`Sending to ${to}... `);
+    const result = await sendTextMessage(to, text, token, baseUrl);
+    const ret = result?.ret ?? result?.errcode;
+    if (ret === 0 || ret === undefined) {
+        console.log("✅ Sent");
+    }
+    else {
+        console.log(`❌ Failed (ret=${ret})`);
+        console.log(JSON.stringify(result, null, 2));
+    }
+}
+export async function cliPoll(args) {
+    const watch = args.includes("--watch") || args.includes("-w");
+    const reset = args.includes("--reset");
+    const { token, baseUrl = DEFAULT_BASE_URL, accountId } = loadAccount();
+    if (watch) {
+        console.log("Watching for messages (Ctrl+C to stop)...\n");
+        let cursor = reset ? "" : loadCursor(accountId);
+        while (true) {
+            try {
+                const resp = await getUpdates(token, baseUrl, cursor);
+                if (resp.get_updates_buf) {
+                    cursor = resp.get_updates_buf;
+                    saveCursor(accountId, cursor);
+                }
+                if (resp.msgs && resp.msgs.length > 0) {
+                    const ts = new Date().toLocaleTimeString();
+                    for (const msg of resp.msgs) {
+                        console.log(`[${ts}] ${formatMsg(msg)}`);
+                    }
+                }
+            }
+            catch (err) {
+                console.error("Poll error:", err instanceof Error ? err.message : String(err));
+                await new Promise((r) => setTimeout(r, 3000));
+            }
+            // getupdates is long-poll, no need for extra delay
+        }
+    }
+    else {
+        // One-shot poll
+        const cursor = reset ? "" : loadCursor(accountId);
+        const resp = await getUpdates(token, baseUrl, cursor);
+        if (resp.get_updates_buf)
+            saveCursor(accountId, resp.get_updates_buf);
+        const msgs = resp.msgs ?? [];
+        if (msgs.length === 0) {
+            console.log("No new messages.");
+        }
+        else {
+            console.log(`${msgs.length} message(s):\n`);
+            for (const msg of msgs) {
+                console.log(formatMsg(msg));
+            }
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weixin-mcp",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "MCP server for WeChat (Weixin) — send messages via OpenClaw weixin plugin auth",
   "type": "module",
   "main": "dist/index.js",

package/src/cli.ts

@@ -45,7 +45,15 @@ if (command === "login") {
 
 } else if (command === "accounts") {
   const { manageAccounts } = await import("./accounts.js");
-  await manageAccounts(process.argv.slice(3)); // [subcommand, ...args]
+  await manageAccounts(process.argv.slice(3));
+
+} else if (command === "send") {
+  const { cliSend } = await import("./messaging.js");
+  await cliSend(process.argv.slice(3)); // <userId> <text...>
+
+} else if (command === "poll") {
+  const { cliPoll } = await import("./messaging.js");
+  await cliPoll(process.argv.slice(3)); // [--watch] [--reset]
 
 } else if (command === undefined || command === "serve") {
   // Default: stdio MCP server (for Claude Desktop integration)
@@ -64,6 +72,8 @@ Commands:
   stop                         Stop daemon
   restart                      Restart daemon
   logs [-f]                    Show daemon logs (-f to follow)
+  send <userId> <text>         Send a message from CLI
+  poll [--watch|-w] [--reset]  Poll messages once, or watch continuously
   accounts [list]              List all accounts
   accounts remove <id>         Remove an account
   accounts clean               Remove duplicate accounts (same userId), keep newest

package/src/messaging.ts

@@ -0,0 +1,110 @@
+/**
+ * CLI messaging commands:
+ *   npx weixin-mcp send <userId> <text>   — send a message
+ *   npx weixin-mcp poll [--watch] [--reset] — poll for messages (once or continuous)
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { ACCOUNTS_DIR } from "./paths.js";
+import {
+  DEFAULT_BASE_URL,
+  sendTextMessage,
+  getUpdates,
+  loadCursor,
+  saveCursor,
+} from "./api.js";
+
+interface AccountData { token?: string; baseUrl?: string; userId?: string }
+
+function loadAccount(): AccountData & { accountId: string } {
+  const files = fs.readdirSync(ACCOUNTS_DIR).filter(
+    (f) => f.endsWith(".json") && !f.endsWith(".sync.json") && !f.endsWith(".cursor.json"),
+  );
+  if (files.length === 0) throw new Error("No account. Run: npx weixin-mcp login");
+  const accountId = process.env.WEIXIN_ACCOUNT_ID ?? files[0].replace(".json", "");
+  const data = JSON.parse(fs.readFileSync(path.join(ACCOUNTS_DIR, `${accountId}.json`), "utf-8")) as AccountData;
+  if (!data.token) throw new Error(`No token for ${accountId}. Run: npx weixin-mcp login`);
+  return { ...data, accountId };
+}
+
+function formatMsg(msg: Record<string, unknown>): string {
+  const from = String(msg.from_user_id ?? "?");
+  const items = (msg.item_list as Array<{ type: number; text_item?: { text: string }; image_item?: { url: string } }>) ?? [];
+  const parts: string[] = [];
+  for (const item of items) {
+    if (item.type === 1 && item.text_item?.text) parts.push(item.text_item.text);
+    else if (item.type === 2 && item.image_item?.url) parts.push(`[image: ${item.image_item.url}]`);
+    else parts.push(`[type:${item.type}]`);
+  }
+  const msgType = Number(msg.message_type);
+  const prefix = msgType === 1 ? "← " : "→ "; // incoming vs outgoing
+  return `${prefix}${from.slice(0, 20)}: ${parts.join(" ") || "(empty)"}`;
+}
+
+export async function cliSend(args: string[]) {
+  const [to, ...textParts] = args;
+  if (!to || textParts.length === 0) {
+    console.error("Usage: npx weixin-mcp send <userId> <message text>");
+    process.exit(1);
+  }
+  const text = textParts.join(" ");
+  const { token, baseUrl = DEFAULT_BASE_URL } = loadAccount();
+
+  process.stdout.write(`Sending to ${to}... `);
+  const result = await sendTextMessage(to, text, token!, baseUrl) as Record<string, unknown>;
+  const ret = result?.ret ?? result?.errcode;
+  if (ret === 0 || ret === undefined) {
+    console.log("✅ Sent");
+  } else {
+    console.log(`❌ Failed (ret=${ret})`);
+    console.log(JSON.stringify(result, null, 2));
+  }
+}
+
+export async function cliPoll(args: string[]) {
+  const watch = args.includes("--watch") || args.includes("-w");
+  const reset = args.includes("--reset");
+
+  const { token, baseUrl = DEFAULT_BASE_URL, accountId } = loadAccount();
+
+  if (watch) {
+    console.log("Watching for messages (Ctrl+C to stop)...\n");
+    let cursor = reset ? "" : loadCursor(accountId);
+
+    while (true) {
+      try {
+        const resp = await getUpdates(token!, baseUrl, cursor);
+        if (resp.get_updates_buf) {
+          cursor = resp.get_updates_buf;
+          saveCursor(accountId, cursor);
+        }
+        if (resp.msgs && resp.msgs.length > 0) {
+          const ts = new Date().toLocaleTimeString();
+          for (const msg of resp.msgs) {
+            console.log(`[${ts}] ${formatMsg(msg as Record<string, unknown>)}`);
+          }
+        }
+      } catch (err) {
+        console.error("Poll error:", err instanceof Error ? err.message : String(err));
+        await new Promise((r) => setTimeout(r, 3000));
+      }
+      // getupdates is long-poll, no need for extra delay
+    }
+  } else {
+    // One-shot poll
+    const cursor = reset ? "" : loadCursor(accountId);
+    const resp = await getUpdates(token!, baseUrl, cursor);
+    if (resp.get_updates_buf) saveCursor(accountId, resp.get_updates_buf);
+
+    const msgs = resp.msgs ?? [];
+    if (msgs.length === 0) {
+      console.log("No new messages.");
+    } else {
+      console.log(`${msgs.length} message(s):\n`);
+      for (const msg of msgs) {
+        console.log(formatMsg(msg as Record<string, unknown>));
+      }
+    }
+  }
+}