weixin-mcp 1.7.3 → 1.7.5

package/README.en.md

@@ -91,6 +91,22 @@ npx weixin-mcp send abc12 "hello"
 # ✓ Resolved "abc12" → abc123xyz456@im.wechat
 ```
 
+### Send Images/Files/Videos
+
+```bash
+# Send image
+npx weixin-mcp send abc12 --image /path/to/photo.jpg
+
+# Send file
+npx weixin-mcp send abc12 --file /path/to/document.pdf
+
+# Send video
+npx weixin-mcp send abc12 --video /path/to/video.mp4
+
+# With caption
+npx weixin-mcp send abc12 --image /path/to/photo.jpg --caption "Check this out"
+```
+
 ---
 
 ## 🔧 MCP Tools
@@ -143,6 +159,41 @@ Priority: `$WEIXIN_MCP_DIR` > `~/.openclaw/openclaw-weixin/` > `~/.weixin-mcp/`
 
 ---
 
+## 🔀 Multi-Instance Mode
+
+One bot = one WeChat account. For multiple accounts, run instances in different directories:
+
+```bash
+# Instance A (port 3001)
+WEIXIN_MCP_DIR=~/.weixin-mcp-a npx weixin-mcp login
+WEIXIN_MCP_DIR=~/.weixin-mcp-a npx weixin-mcp start --port 3001
+
+# Instance B (port 3002)
+WEIXIN_MCP_DIR=~/.weixin-mcp-b npx weixin-mcp login
+WEIXIN_MCP_DIR=~/.weixin-mcp-b npx weixin-mcp start --port 3002
+```
+
+Claude Desktop multi-account config:
+
+```json
+{
+  "mcpServers": {
+    "weixin-personal": {
+      "command": "npx",
+      "args": ["weixin-mcp", "start", "--port", "3001"],
+      "env": { "WEIXIN_MCP_DIR": "/Users/you/.weixin-mcp-personal" }
+    },
+    "weixin-work": {
+      "command": "npx",
+      "args": ["weixin-mcp", "start", "--port", "3002"],
+      "env": { "WEIXIN_MCP_DIR": "/Users/you/.weixin-mcp-work" }
+    }
+  }
+}
+```
+
+---
+
 ## 🔗 Related Projects
 
 - [OpenClaw](https://github.com/anthropics/openclaw) — AI Agent Infrastructure

package/README.md

@@ -91,6 +91,22 @@ npx weixin-mcp send abc12 "hello"
 # ✓ Resolved "abc12" → abc123xyz456@im.wechat
 ```
 
+### 发送图片/文件/视频
+
+```bash
+# 发送图片
+npx weixin-mcp send abc12 --image /path/to/photo.jpg
+
+# 发送文件
+npx weixin-mcp send abc12 --file /path/to/document.pdf
+
+# 发送视频
+npx weixin-mcp send abc12 --video /path/to/video.mp4
+
+# 带文字说明
+npx weixin-mcp send abc12 --image /path/to/photo.jpg --caption "看看这张图"
+```
+
 ---
 
 ## 🔧 MCP 工具
@@ -143,6 +159,41 @@ npx weixin-mcp start --webhook http://your-server/weixin-hook
 
 ---
 
+## 🔀 多实例模式
+
+一个 bot = 一个微信账号。需要多账号时，用不同目录运行多个实例：
+
+```bash
+# 实例 A（端口 3001）
+WEIXIN_MCP_DIR=~/.weixin-mcp-a npx weixin-mcp login
+WEIXIN_MCP_DIR=~/.weixin-mcp-a npx weixin-mcp start --port 3001
+
+# 实例 B（端口 3002）
+WEIXIN_MCP_DIR=~/.weixin-mcp-b npx weixin-mcp login
+WEIXIN_MCP_DIR=~/.weixin-mcp-b npx weixin-mcp start --port 3002
+```
+
+Claude Desktop 配置多账号：
+
+```json
+{
+  "mcpServers": {
+    "weixin-personal": {
+      "command": "npx",
+      "args": ["weixin-mcp", "start", "--port", "3001"],
+      "env": { "WEIXIN_MCP_DIR": "/Users/you/.weixin-mcp-personal" }
+    },
+    "weixin-work": {
+      "command": "npx",
+      "args": ["weixin-mcp", "start", "--port", "3002"],
+      "env": { "WEIXIN_MCP_DIR": "/Users/you/.weixin-mcp-work" }
+    }
+  }
+}
+```
+
+---
+
 ## 🔗 相关项目
 
 - [OpenClaw](https://github.com/anthropics/openclaw) — AI Agent 基础设施

package/dist/api.d.ts

@@ -53,3 +53,13 @@ export declare function sendFileMessage(to: string, uploaded: UploadedMedia, tok
  * Send a video message using a previously uploaded file.
  */
 export declare function sendVideoMessage(to: string, uploaded: UploadedMedia, token: string, baseUrl: string, contextToken?: string, caption?: string): Promise<void>;
+export type MediaSendType = "image" | "file" | "video";
+export declare function sendMediaMessage(opts: {
+    to: string;
+    mediaType: MediaSendType;
+    uploaded: UploadedMedia;
+    caption?: string;
+    token: string;
+    baseUrl: string;
+    contextToken?: string;
+}): Promise<void>;

package/dist/api.js

@@ -249,3 +249,15 @@ export async function sendVideoMessage(to, uploaded, token, baseUrl, contextToke
         }, token, baseUrl);
     }
 }
+export async function sendMediaMessage(opts) {
+    switch (opts.mediaType) {
+        case "image":
+            return sendImageMessage(opts.to, opts.uploaded, opts.token, opts.baseUrl, opts.contextToken, opts.caption);
+        case "file":
+            return sendFileMessage(opts.to, opts.uploaded, opts.token, opts.baseUrl, opts.contextToken, opts.caption);
+        case "video":
+            return sendVideoMessage(opts.to, opts.uploaded, opts.token, opts.baseUrl, opts.contextToken, opts.caption);
+        default:
+            throw new Error(`Unknown media type: ${opts.mediaType}`);
+    }
+}

package/dist/cli.js

@@ -122,7 +122,10 @@ Commands:
   contacts                     Show contact book (users who messaged the bot)
   update                       Check and install latest version
   --version / -v               Print version
-  send <userId> <text>         Send a message from CLI
+  send <userId> <text>         Send a text message
+  send <userId> --image <path> [--caption <text>]  Send an image
+  send <userId> --file <path> [--caption <text>]   Send a file
+  send <userId> --video <path> [--caption <text>]  Send a video
   poll [--watch|-w] [--reset]  Poll messages once, or watch continuously
   accounts [list]              List all accounts
   accounts remove <id>         Remove an account

package/dist/messaging.js

@@ -6,7 +6,8 @@
 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";
+import { DEFAULT_BASE_URL, sendTextMessage, sendMediaMessage, getUpdates, loadCursor, saveCursor, } from "./api.js";
+import { uploadMedia } from "./cdn.js";
 import { updateContactsFromMsgs, loadContacts } from "./contacts.js";
 /** Resolve a short/partial userId to a full one from contacts. */
 function resolveUserId(input) {
@@ -52,26 +53,94 @@ function formatMsg(msg) {
     const prefix = msgType === 1 ? "← " : "→ "; // incoming vs outgoing
     return `${prefix}${from.slice(0, 20)}: ${parts.join(" ") || "(empty)"}`;
 }
+function parseCliSendArgs(args) {
+    const opts = { to: "" };
+    let i = 0;
+    // First arg is always <to>
+    if (args[i] && !args[i].startsWith("--")) {
+        opts.to = args[i++];
+    }
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === "--image" && args[i + 1]) {
+            opts.image = args[++i];
+        }
+        else if (arg === "--file" && args[i + 1]) {
+            opts.file = args[++i];
+        }
+        else if (arg === "--video" && args[i + 1]) {
+            opts.video = args[++i];
+        }
+        else if (arg === "--caption" && args[i + 1]) {
+            opts.caption = args[++i];
+        }
+        else if (!arg.startsWith("--")) {
+            // Collect remaining as text
+            opts.text = args.slice(i).join(" ");
+            break;
+        }
+        i++;
+    }
+    return opts;
+}
 export async function cliSend(args) {
-    const [to, ...textParts] = args;
-    if (!to || textParts.length === 0) {
-        console.error("Usage: npx weixin-mcp send <userId> <message text>");
+    const opts = parseCliSendArgs(args);
+    if (!opts.to) {
+        console.error(`Usage: npx weixin-mcp send <userId> <text>
+       npx weixin-mcp send <userId> --image <path> [--caption <text>]
+       npx weixin-mcp send <userId> --file <path> [--caption <text>]
+       npx weixin-mcp send <userId> --video <path> [--caption <text>]`);
         process.exit(1);
     }
-    const text = textParts.join(" ");
-    const resolvedTo = resolveUserId(to);
-    if (resolvedTo !== to)
-        console.log(`Resolved "${to}" → ${resolvedTo}`);
+    const resolvedTo = resolveUserId(opts.to);
+    if (resolvedTo !== opts.to)
+        console.log(`Resolved "${opts.to}" → ${resolvedTo}`);
     const { token, baseUrl = DEFAULT_BASE_URL } = loadAccount();
-    process.stdout.write(`Sending to ${resolvedTo}... `);
-    const result = await sendTextMessage(resolvedTo, text, token, baseUrl);
-    const ret = result?.ret ?? result?.errcode;
-    if (ret === 0 || ret === undefined) {
+    // Determine what to send
+    const mediaPath = opts.image || opts.file || opts.video;
+    const mediaType = opts.image ? "image" : opts.file ? "file" : opts.video ? "video" : null;
+    if (mediaPath && mediaType) {
+        // Check file exists
+        if (!fs.existsSync(mediaPath)) {
+            console.error(`File not found: ${mediaPath}`);
+            process.exit(1);
+        }
+        process.stdout.write(`Uploading ${mediaType}... `);
+        const uploaded = await uploadMedia({
+            source: mediaPath,
+            mediaType,
+            toUserId: resolvedTo,
+            token: token,
+            baseUrl,
+        });
+        console.log("✅");
+        process.stdout.write(`Sending ${mediaType} to ${resolvedTo}... `);
+        await sendMediaMessage({
+            to: resolvedTo,
+            mediaType,
+            uploaded,
+            caption: opts.caption,
+            token: token,
+            baseUrl,
+        });
         console.log("✅ Sent");
     }
+    else if (opts.text) {
+        // Text message
+        process.stdout.write(`Sending to ${resolvedTo}... `);
+        const result = await sendTextMessage(resolvedTo, opts.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));
+        }
+    }
     else {
-        console.log(`❌ Failed (ret=${ret})`);
-        console.log(JSON.stringify(result, null, 2));
+        console.error("Nothing to send. Provide text or --image/--file/--video");
+        process.exit(1);
     }
 }
 export async function cliPoll(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weixin-mcp",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "description": "MCP server for WeChat — send text, images, files, videos; receive via webhook; works with Claude Desktop, Cursor, OpenClaw",
   "type": "module",
   "main": "dist/index.js",

package/src/api.ts

@@ -355,3 +355,28 @@ export async function sendVideoMessage(
     );
   }
 }
+
+// ── Unified media sender for CLI ───────────────────────────────────────────
+
+export type MediaSendType = "image" | "file" | "video";
+
+export async function sendMediaMessage(opts: {
+  to: string;
+  mediaType: MediaSendType;
+  uploaded: UploadedMedia;
+  caption?: string;
+  token: string;
+  baseUrl: string;
+  contextToken?: string;
+}) {
+  switch (opts.mediaType) {
+    case "image":
+      return sendImageMessage(opts.to, opts.uploaded, opts.token, opts.baseUrl, opts.contextToken, opts.caption);
+    case "file":
+      return sendFileMessage(opts.to, opts.uploaded, opts.token, opts.baseUrl, opts.contextToken, opts.caption);
+    case "video":
+      return sendVideoMessage(opts.to, opts.uploaded, opts.token, opts.baseUrl, opts.contextToken, opts.caption);
+    default:
+      throw new Error(`Unknown media type: ${opts.mediaType}`);
+  }
+}

package/src/cli.ts

@@ -124,7 +124,10 @@ Commands:
   contacts                     Show contact book (users who messaged the bot)
   update                       Check and install latest version
   --version / -v               Print version
-  send <userId> <text>         Send a message from CLI
+  send <userId> <text>         Send a text message
+  send <userId> --image <path> [--caption <text>]  Send an image
+  send <userId> --file <path> [--caption <text>]   Send a file
+  send <userId> --video <path> [--caption <text>]  Send a video
   poll [--watch|-w] [--reset]  Poll messages once, or watch continuously
   accounts [list]              List all accounts
   accounts remove <id>         Remove an account

package/src/messaging.ts

@@ -10,10 +10,12 @@ import { ACCOUNTS_DIR } from "./paths.js";
 import {
   DEFAULT_BASE_URL,
   sendTextMessage,
+  sendMediaMessage,
   getUpdates,
   loadCursor,
   saveCursor,
 } from "./api.js";
+import { uploadMedia, type MediaType } from "./cdn.js";
 import { updateContactsFromMsgs, loadContacts } from "./contacts.js";
 
 /** Resolve a short/partial userId to a full one from contacts. */
@@ -59,25 +61,104 @@ function formatMsg(msg: Record<string, unknown>): string {
   return `${prefix}${from.slice(0, 20)}: ${parts.join(" ") || "(empty)"}`;
 }
 
+interface SendOptions {
+  to: string;
+  text?: string;
+  image?: string;
+  file?: string;
+  video?: string;
+  caption?: string;
+}
+
+function parseCliSendArgs(args: string[]): SendOptions {
+  const opts: SendOptions = { to: "" };
+  let i = 0;
+  
+  // First arg is always <to>
+  if (args[i] && !args[i].startsWith("--")) {
+    opts.to = args[i++];
+  }
+  
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "--image" && args[i + 1]) {
+      opts.image = args[++i];
+    } else if (arg === "--file" && args[i + 1]) {
+      opts.file = args[++i];
+    } else if (arg === "--video" && args[i + 1]) {
+      opts.video = args[++i];
+    } else if (arg === "--caption" && args[i + 1]) {
+      opts.caption = args[++i];
+    } else if (!arg.startsWith("--")) {
+      // Collect remaining as text
+      opts.text = args.slice(i).join(" ");
+      break;
+    }
+    i++;
+  }
+  return opts;
+}
+
 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>");
+  const opts = parseCliSendArgs(args);
+  
+  if (!opts.to) {
+    console.error(`Usage: npx weixin-mcp send <userId> <text>
+       npx weixin-mcp send <userId> --image <path> [--caption <text>]
+       npx weixin-mcp send <userId> --file <path> [--caption <text>]
+       npx weixin-mcp send <userId> --video <path> [--caption <text>]`);
     process.exit(1);
   }
-  const text = textParts.join(" ");
-  const resolvedTo = resolveUserId(to);
-  if (resolvedTo !== to) console.log(`Resolved "${to}" → ${resolvedTo}`);
+  
+  const resolvedTo = resolveUserId(opts.to);
+  if (resolvedTo !== opts.to) console.log(`Resolved "${opts.to}" → ${resolvedTo}`);
   const { token, baseUrl = DEFAULT_BASE_URL } = loadAccount();
-
-  process.stdout.write(`Sending to ${resolvedTo}... `);
-  const result = await sendTextMessage(resolvedTo, text, token!, baseUrl) as Record<string, unknown>;
-  const ret = result?.ret ?? result?.errcode;
-  if (ret === 0 || ret === undefined) {
+  
+  // Determine what to send
+  const mediaPath = opts.image || opts.file || opts.video;
+  const mediaType: MediaType | null = opts.image ? "image" : opts.file ? "file" : opts.video ? "video" : null;
+  
+  if (mediaPath && mediaType) {
+    // Check file exists
+    if (!fs.existsSync(mediaPath)) {
+      console.error(`File not found: ${mediaPath}`);
+      process.exit(1);
+    }
+    
+    process.stdout.write(`Uploading ${mediaType}... `);
+    const uploaded = await uploadMedia({
+      source: mediaPath,
+      mediaType,
+      toUserId: resolvedTo,
+      token: token!,
+      baseUrl,
+    });
+    console.log("✅");
+    
+    process.stdout.write(`Sending ${mediaType} to ${resolvedTo}... `);
+    await sendMediaMessage({
+      to: resolvedTo,
+      mediaType,
+      uploaded,
+      caption: opts.caption,
+      token: token!,
+      baseUrl,
+    });
     console.log("✅ Sent");
+  } else if (opts.text) {
+    // Text message
+    process.stdout.write(`Sending to ${resolvedTo}... `);
+    const result = await sendTextMessage(resolvedTo, opts.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));
+    }
   } else {
-    console.log(`❌ Failed (ret=${ret})`);
-    console.log(JSON.stringify(result, null, 2));
+    console.error("Nothing to send. Provide text or --image/--file/--video");
+    process.exit(1);
   }
 }