md2wechat-mcp 0.1.3 → 0.2.0

package/dist/markdown.js

@@ -18,6 +18,10 @@ export function inlineFormat(text, theme) {
     escaped = escaped.replace(/`([^`]+)`/g, (_, code) => {
         return stash(`<code style=\"${theme.code_inline}\">${code}</code>`);
     });
+    // Images must be processed before links (pattern starts with `!`)
+    escaped = escaped.replace(/!\[([^\]]*)\]\((https?:\/\/[^\s)]+)\)/g, (_m, alt, src) => {
+        return stash(`<img src=\"${src}\" alt=\"${alt}\" style=\"max-width:100%;height:auto;display:block;margin:0.8em auto;\" />`);
+    });
     escaped = escaped.replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g, (_m, label, href) => {
         return `<a href=\"${href}\" style=\"${theme.a}\">${label}</a>`;
     });
@@ -68,6 +72,8 @@ export function parseMarkdown(md, themeName = "default", title) {
     let codeLines = [];
     let listType;
     let listItems = [];
+    let olStart = 1;
+    let olNextExpected;
     let paragraphBuffer = [];
     const flushParagraph = () => {
         if (paragraphBuffer.length > 0) {
@@ -81,7 +87,15 @@ export function parseMarkdown(md, themeName = "default", title) {
     const flushList = () => {
         if (listType && listItems.length > 0) {
             const renderedItems = listItems.map((item) => `<li style=\"${theme.li}\">${item}</li>`).join("");
-            out.push(`<${listType} style=\"margin: 0.6em 0 0.9em 1.2em; padding: 0;\">${renderedItems}</${listType}>`);
+            if (listType === "ol") {
+                const startAttr = olStart !== 1 ? ` start=\"${olStart}\"` : "";
+                out.push(`<ol${startAttr} style=\"margin: 0.6em 0 0.9em 1.2em; padding: 0;\">${renderedItems}</ol>`);
+                olNextExpected = olStart + listItems.length;
+            }
+            else {
+                out.push(`<ul style=\"margin: 0.6em 0 0.9em 1.2em; padding: 0;\">${renderedItems}</ul>`);
+                olNextExpected = undefined;
+            }
         }
         listType = undefined;
         listItems = [];
@@ -209,14 +223,25 @@ export function parseMarkdown(md, themeName = "default", title) {
             listItems.push(inlineFormat(ul[1], theme));
             continue;
         }
-        const ol = line.match(/^\s*\d+\.\s+(.+)$/u);
+        const ol = line.match(/^\s*(\d+)\.\s+(.+)$/u);
         if (ol) {
             flushParagraph();
+            const itemNum = parseInt(ol[1], 10);
             if (listType && listType !== "ol") {
                 flushList();
             }
+            if (listType !== "ol") {
+                // Starting a new ol group: check if this continues a previous flushed group
+                if (olNextExpected !== undefined && itemNum === olNextExpected) {
+                    olStart = itemNum;
+                }
+                else {
+                    olStart = itemNum;
+                    olNextExpected = undefined;
+                }
+            }
             listType = "ol";
-            listItems.push(inlineFormat(ol[1], theme));
+            listItems.push(inlineFormat(ol[2], theme));
             continue;
         }
         flushList();

package/dist/server.js

@@ -8,15 +8,46 @@ import pkg from "../package.json" with { type: "json" };
 const SERVER_NAME = pkg.name;
 const SERVER_VERSION = pkg.version;
 const themeSchema = z.enum(["default", "tech", "warm", "apple", "wechat-native"]);
+const SERVER_INSTRUCTIONS = `
+## 发布 Markdown 图文到微信公众号草稿箱
+
+前置条件：MCP server 配置环境变量 WECHAT_APPID 和 WECHAT_APPSECRET。
+
+完整工作流：
+
+Step 1 — 获取 access_token
+  wechat_get_access_token() → { access_token, expires_in }
+  同一次任务保存复用，无需重复获取（有效期 7200 秒）。
+
+Step 2 — 转换 Markdown 并自动上传本地图片
+  convert_markdown_to_wechat_html(markdown_path, access_token, theme?, title?)
+  传入 access_token 后，![alt](./local/path) 形式的本地图片自动上传并替换为微信 CDN URL。
+
+Step 3（可选）— 上传文章内嵌图片
+  wechat_upload_image(access_token, file_path) → { url }
+  返回的 url 可用于文章 HTML 中的 <img src>，但不能用作封面 thumb_media_id。
+
+Step 4 — 新增草稿
+  wechat_draft_add(access_token, articles: [{ title, content, author?, digest?, thumb_media_id?, ... }])
+  content 使用 Step 2 返回的 HTML。返回 media_id 可用于后续更新或删除。
+
+其他工具：
+  wechat_draft_batchget — 分页查询草稿列表
+  wechat_draft_update  — 按 media_id 更新草稿
+  wechat_draft_delete  — 按 media_id 删除草稿
+
+常见错误：40005=图片格式不支持，40009=图片超1MB，access_token过期重新调用Step1。
+`.trim();
 export function createServer() {
-    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { instructions: SERVER_INSTRUCTIONS });
     server.registerTool("convert_markdown_to_wechat_html", {
         description: "Convert Markdown to WeChat-friendly HTML with inline styles for copy/paste publishing workflows.",
         inputSchema: {
             markdown: z.string().optional().describe("Source markdown text. If both markdown and markdown_path are provided, markdown is used."),
             markdown_path: z.string().optional().describe("Local markdown file path. Use this to avoid sending full content through tokens."),
             theme: themeSchema.optional().default("default").describe("Theme name: default | tech | warm | apple | wechat-native"),
-            title: z.string().optional().describe("Optional article title rendered as h1")
+            title: z.string().optional().describe("Optional article title rendered as h1"),
+            access_token: z.string().optional().describe("WeChat API access token. When provided, local images referenced as ![alt](./path) are automatically uploaded to WeChat CDN and replaced with permanent URLs.")
         }
     }, async (args) => handleToolCall("convert_markdown_to_wechat_html", args));
     server.registerTool("list_wechat_themes", {
@@ -29,6 +60,60 @@ export function createServer() {
             cacheHtmlPath: z.string().describe("Existing cached HTML file path to open directly")
         }
     }, async (args) => handleToolCall("open_wechat_html_in_browser", args));
+    const articleSchema = z.object({
+        article_type: z.enum(["news", "newspic"]).optional().describe("Article type: news (text+image) or newspic (pure image). Defaults to news."),
+        title: z.string().describe("Article title (max 32 chars)"),
+        author: z.string().optional().describe("Author name (max 16 chars)"),
+        digest: z.string().optional().describe("Article summary shown in list view (max 128 chars)"),
+        content: z.string().describe("Article HTML content (max 20000 chars). Use convert_markdown_to_wechat_html to generate this."),
+        content_source_url: z.string().optional().describe("Original article URL (max 1024 chars)"),
+        thumb_media_id: z.string().optional().describe("Cover image media ID obtained from WeChat material upload API"),
+        need_open_comment: z.union([z.literal(0), z.literal(1)]).optional().describe("Enable comments: 1 = yes, 0 = no"),
+        only_fans_can_comment: z.union([z.literal(0), z.literal(1)]).optional().describe("Only followers can comment: 1 = yes, 0 = no")
+    });
+    server.registerTool("wechat_get_access_token", {
+        description: "Get WeChat API access_token. Reads AppID and AppSecret from environment variables WECHAT_APPID and WECHAT_APPSECRET. The token is valid for 7200 seconds.",
+        inputSchema: {}
+    }, async () => handleToolCall("wechat_get_access_token", {}));
+    server.registerTool("wechat_draft_add", {
+        description: "Add a new draft to WeChat Official Account draft box. Returns media_id for the created draft.",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            articles: z.array(articleSchema).min(1).describe("Array of articles to include in the draft (usually 1)")
+        }
+    }, async (args) => handleToolCall("wechat_draft_add", args));
+    server.registerTool("wechat_draft_update", {
+        description: "Update an existing draft in WeChat Official Account draft box by media_id.",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            media_id: z.string().describe("Draft media_id returned from wechat_draft_add"),
+            index: z.number().int().min(0).default(0).describe("0-based index of article to update within the draft"),
+            article: articleSchema.describe("Updated article content")
+        }
+    }, async (args) => handleToolCall("wechat_draft_update", args));
+    server.registerTool("wechat_upload_image", {
+        description: "Upload a local JPG/PNG image (max 1MB) to WeChat for use in article content. Returns a permanent image URL. Does not count toward the 100,000 material limit.",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            file_path: z.string().describe("Absolute local path to the image file (JPG or PNG, max 1MB)")
+        }
+    }, async (args) => handleToolCall("wechat_upload_image", args));
+    server.registerTool("wechat_draft_batchget", {
+        description: "Query draft list from WeChat Official Account draft box with pagination.",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            offset: z.number().int().min(0).default(0).describe("Starting offset (0 = first item)"),
+            count: z.number().int().min(1).max(20).default(10).describe("Number of drafts to return (1-20)"),
+            no_content: z.union([z.literal(0), z.literal(1)]).optional().default(0).describe("1 = exclude article content field to reduce response size, 0 = include (default)")
+        }
+    }, async (args) => handleToolCall("wechat_draft_batchget", args));
+    server.registerTool("wechat_draft_delete", {
+        description: "Delete a draft from WeChat Official Account draft box by media_id. This action is irreversible.",
+        inputSchema: {
+            access_token: z.string().describe("WeChat API access token from wechat_get_access_token"),
+            media_id: z.string().describe("Draft media_id to delete")
+        }
+    }, async (args) => handleToolCall("wechat_draft_delete", args));
     return server;
 }
 export async function main() {

package/dist/tools.js

@@ -3,6 +3,7 @@ import { saveHtmlCache } from "./cache.js";
 import { openFileInBrowser } from "./browser.js";
 import { THEME_NAMES, THEMES } from "./themes.js";
 import { readFile } from "node:fs/promises";
+import { getAccessToken, draftAdd, draftUpdate, draftDelete, draftBatchGet, uploadImage } from "./wechat-api.js";
 export function listThemesPayload() {
     return {
         themes: [
@@ -76,6 +77,37 @@ export async function handleToolCall(name, args) {
             return invalidThemeResult(theme);
         }
         const title = typeof args.title === "string" ? args.title : undefined;
+        // Upload local images if access_token is provided
+        const accessToken = typeof args.access_token === "string" ? args.access_token.trim() : undefined;
+        if (accessToken) {
+            const baseDir = typeof markdownPath === "string" ? markdownPath.replace(/[^/\\]+$/, "") : "";
+            const localImagePattern = /!\[([^\]]*)\]\((?!https?:\/\/)([^)]+)\)/g;
+            const uploadErrors = [];
+            const uploadCache = new Map();
+            const matches = [...markdown.matchAll(localImagePattern)];
+            for (const match of matches) {
+                const rawPath = match[2];
+                if (!rawPath || uploadCache.has(rawPath))
+                    continue;
+                const absPath = rawPath.startsWith("/") ? rawPath : `${baseDir}${rawPath}`;
+                try {
+                    const result = await uploadImage(accessToken, absPath);
+                    uploadCache.set(rawPath, result.url);
+                }
+                catch (error) {
+                    uploadErrors.push(`${rawPath}: ${error.message}`);
+                }
+            }
+            for (const [localPath, cdnUrl] of uploadCache) {
+                markdown = markdown.replaceAll(`](${localPath})`, `](${cdnUrl})`);
+            }
+            if (uploadErrors.length > 0) {
+                return {
+                    content: [{ type: "text", text: `Image upload failed:\n${uploadErrors.join("\n")}` }],
+                    isError: true
+                };
+            }
+        }
         const html = parseMarkdown(markdown, theme, title);
         const savedPath = saveHtmlCache(html);
         return {
@@ -112,6 +144,125 @@ export async function handleToolCall(name, args) {
             meta: { cacheHtmlPath: openedPath }
         };
     }
+    if (name === "wechat_get_access_token") {
+        const appid = process.env.WECHAT_APPID;
+        const secret = process.env.WECHAT_APPSECRET;
+        if (!appid) {
+            return { content: [{ type: "text", text: "Environment variable WECHAT_APPID is not set." }], isError: true };
+        }
+        if (!secret) {
+            return { content: [{ type: "text", text: "Environment variable WECHAT_APPSECRET is not set." }], isError: true };
+        }
+        try {
+            const result = await getAccessToken(appid, secret);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    }
+    if (name === "wechat_draft_add") {
+        const accessToken = args.access_token;
+        const articles = args.articles;
+        if (typeof accessToken !== "string" || !accessToken.trim()) {
+            return { content: [{ type: "text", text: "access_token is required." }], isError: true };
+        }
+        if (!Array.isArray(articles) || articles.length === 0) {
+            return { content: [{ type: "text", text: "articles must be a non-empty array." }], isError: true };
+        }
+        try {
+            const result = await draftAdd(accessToken, articles);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    }
+    if (name === "wechat_draft_update") {
+        const accessToken = args.access_token;
+        const mediaId = args.media_id;
+        const index = args.index ?? 0;
+        const article = args.article;
+        if (typeof accessToken !== "string" || !accessToken.trim()) {
+            return { content: [{ type: "text", text: "access_token is required." }], isError: true };
+        }
+        if (typeof mediaId !== "string" || !mediaId.trim()) {
+            return { content: [{ type: "text", text: "media_id is required." }], isError: true };
+        }
+        if (typeof index !== "number") {
+            return { content: [{ type: "text", text: "index must be a number." }], isError: true };
+        }
+        if (typeof article !== "object" || article === null) {
+            return { content: [{ type: "text", text: "article is required." }], isError: true };
+        }
+        try {
+            const result = await draftUpdate(accessToken, mediaId, index, article);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    }
+    if (name === "wechat_upload_image") {
+        const accessToken = args.access_token;
+        const filePath = args.file_path;
+        if (typeof accessToken !== "string" || !accessToken.trim()) {
+            return { content: [{ type: "text", text: "access_token is required." }], isError: true };
+        }
+        if (typeof filePath !== "string" || !filePath.trim()) {
+            return { content: [{ type: "text", text: "file_path is required." }], isError: true };
+        }
+        const ext = filePath.toLowerCase().split(".").pop();
+        if (ext !== "jpg" && ext !== "jpeg" && ext !== "png") {
+            return { content: [{ type: "text", text: "Only JPG and PNG files are supported." }], isError: true };
+        }
+        try {
+            const result = await uploadImage(accessToken, filePath);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    }
+    if (name === "wechat_draft_batchget") {
+        const accessToken = args.access_token;
+        const offset = args.offset ?? 0;
+        const count = args.count ?? 10;
+        const noContent = args.no_content ?? 0;
+        if (typeof accessToken !== "string" || !accessToken.trim()) {
+            return { content: [{ type: "text", text: "access_token is required." }], isError: true };
+        }
+        if (typeof offset !== "number" || typeof count !== "number") {
+            return { content: [{ type: "text", text: "offset and count must be numbers." }], isError: true };
+        }
+        if (count < 1 || count > 20) {
+            return { content: [{ type: "text", text: "count must be between 1 and 20." }], isError: true };
+        }
+        try {
+            const result = await draftBatchGet(accessToken, offset, count, noContent);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    }
+    if (name === "wechat_draft_delete") {
+        const accessToken = args.access_token;
+        const mediaId = args.media_id;
+        if (typeof accessToken !== "string" || !accessToken.trim()) {
+            return { content: [{ type: "text", text: "access_token is required." }], isError: true };
+        }
+        if (typeof mediaId !== "string" || !mediaId.trim()) {
+            return { content: [{ type: "text", text: "media_id is required." }], isError: true };
+        }
+        try {
+            const result = await draftDelete(accessToken, mediaId);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error.message }], isError: true };
+        }
+    }
     return {
         content: [{ type: "text", text: `Unknown tool: ${name}` }],
         isError: true

package/dist/wechat-api.d.ts

@@ -0,0 +1,54 @@
+export interface WechatArticle {
+    article_type?: "news" | "newspic";
+    title: string;
+    author?: string;
+    digest?: string;
+    content: string;
+    content_source_url?: string;
+    thumb_media_id?: string;
+    need_open_comment?: 0 | 1;
+    only_fans_can_comment?: 0 | 1;
+}
+export declare function getAccessToken(appid: string, secret: string): Promise<{
+    access_token: string;
+    expires_in: number;
+}>;
+export declare function draftAdd(accessToken: string, articles: WechatArticle[]): Promise<{
+    media_id: string;
+}>;
+export declare function draftUpdate(accessToken: string, mediaId: string, index: number, article: WechatArticle): Promise<{
+    errcode: number;
+    errmsg: string;
+}>;
+export interface DraftNewsItem {
+    article_type: "news" | "newspic";
+    title: string;
+    author: string;
+    digest: string;
+    content: string;
+    content_source_url: string;
+    thumb_media_id: string;
+    need_open_comment: number;
+    only_fans_can_comment: number;
+    url: string;
+}
+export interface DraftItem {
+    media_id: string;
+    content: {
+        news_item: DraftNewsItem[];
+    };
+    update_time: number;
+}
+export interface DraftBatchGetResult {
+    total_count: number;
+    item_count: number;
+    item: DraftItem[];
+}
+export declare function draftBatchGet(accessToken: string, offset: number, count: number, noContent?: 0 | 1): Promise<DraftBatchGetResult>;
+export declare function uploadImage(accessToken: string, filePath: string): Promise<{
+    url: string;
+}>;
+export declare function draftDelete(accessToken: string, mediaId: string): Promise<{
+    errcode: number;
+    errmsg: string;
+}>;

package/dist/wechat-api.js

@@ -0,0 +1,59 @@
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+const WECHAT_BASE = "https://api.weixin.qq.com";
+async function wechatFetch(url, options) {
+    const res = await fetch(url, options);
+    if (!res.ok) {
+        throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+    }
+    const data = (await res.json());
+    if (typeof data.errcode === "number" && data.errcode !== 0) {
+        throw new Error(`WeChat API error ${data.errcode}: ${data.errmsg ?? "unknown"}`);
+    }
+    return data;
+}
+export async function getAccessToken(appid, secret) {
+    const url = `${WECHAT_BASE}/cgi-bin/token?grant_type=client_credential&appid=${encodeURIComponent(appid)}&secret=${encodeURIComponent(secret)}`;
+    return wechatFetch(url);
+}
+export async function draftAdd(accessToken, articles) {
+    const url = `${WECHAT_BASE}/cgi-bin/draft/add?access_token=${encodeURIComponent(accessToken)}`;
+    return wechatFetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        body: JSON.stringify({ articles })
+    });
+}
+export async function draftUpdate(accessToken, mediaId, index, article) {
+    const url = `${WECHAT_BASE}/cgi-bin/draft/update?access_token=${encodeURIComponent(accessToken)}`;
+    return wechatFetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        body: JSON.stringify({ media_id: mediaId, index, articles: article })
+    });
+}
+export async function draftBatchGet(accessToken, offset, count, noContent) {
+    const url = `${WECHAT_BASE}/cgi-bin/draft/batchget?access_token=${encodeURIComponent(accessToken)}`;
+    return wechatFetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        body: JSON.stringify({ offset, count, no_content: noContent ?? 0 })
+    });
+}
+export async function uploadImage(accessToken, filePath) {
+    const url = `${WECHAT_BASE}/cgi-bin/media/uploadimg?access_token=${encodeURIComponent(accessToken)}`;
+    const fileBuffer = await readFile(filePath);
+    const ext = extname(filePath).toLowerCase();
+    const mimeType = ext === ".png" ? "image/png" : "image/jpeg";
+    const form = new FormData();
+    form.append("media", new Blob([fileBuffer], { type: mimeType }), basename(filePath));
+    return wechatFetch(url, { method: "POST", body: form });
+}
+export async function draftDelete(accessToken, mediaId) {
+    const url = `${WECHAT_BASE}/cgi-bin/draft/delete?access_token=${encodeURIComponent(accessToken)}`;
+    return wechatFetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        body: JSON.stringify({ media_id: mediaId })
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md2wechat-mcp",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "directories": {
     "test": "tests"
   },