@wenyan-md/mcp 1.0.8 → 1.0.10

package/README.md

@@ -29,7 +29,7 @@
 
 -   [macOS App Store 版](https://github.com/caol64/wenyan) - MAC 桌面应用
 -   [跨平台桌面版](https://github.com/caol64/wenyan-pc) - Windows/Linux
--   [CLI 版本](https://github.com/caol64/wenyan-cli) - 命令行工具
+-   [CLI 版本](https://github.com/caol64/wenyan-cli) - 命令行 / CI 自动化发布
 -   👉 [MCP 版本](https://github.com/caol64/wenyan-mcp) - 本项目
 -   [核心库](https://github.com/caol64/wenyan-core) - 嵌入 Node / Web 项目
 
@@ -39,7 +39,13 @@
 -   使用内置主题对 Markdown 内容排版
 -   自动处理并上传图片（本地 / 网络）
 -   一键发布文章到微信公众号草稿箱
--   **与 AI 深度集成**：让 AI 帮你管理公众号的排版和发布
+-   **与 AI 深度集成**：[让 AI 帮你管理公众号的排版和发布](https://babyno.top/posts/2025/06/let-ai-help-you-manage-your-gzh-layout-and-publishing/)
+
+<video src="https://github.com/user-attachments/assets/2c355f76-f313-48a7-9c31-f0f69e5ec207"></video>
+
+> [!TIP]
+>
+> 如果与 AI 集成遇到问题，可以参考 [test/list.js](./test/list.js) 和 [test/publish.js](./test/publish.js) 中的完整调用示例。
 
 ## 主题效果预览
 
@@ -160,7 +166,7 @@ cover: /Users/xxx/image.jpg
 
 ## 微信公众号 IP 白名单
 
-> ⚠️ 重要
+> [!IMPORTANT]
 >
 > 请确保运行文颜 MCP Server 的机器 IP 已加入微信公众号后台的 IP 白名单，否则上传接口将调用失败。
 

package/dist/index.js

@@ -9,10 +9,13 @@
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { getGzhContent } from "@wenyan-md/core/wrapper";
 import { publishToDraft } from "@wenyan-md/core/publish";
 import { themes } from "@wenyan-md/core/theme";
+import { getNormalizeFilePath } from "./utils.js";
+import fs from "node:fs/promises";
+import path from "node:path";
 /**
  * Create an MCP server with capabilities for resources (to list/read notes),
  * tools (to create new notes), and prompts (to summarize notes).
@@ -43,14 +46,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {
                         content: {
                             type: "string",
-                            description: "The original Markdown content to publish, preserving its frontmatter (if present).",
+                            description: "The Markdown text to publish. REQUIRED if 'file' is not provided. Preserves frontmatter if present.",
+                        },
+                        file: {
+                            type: "string",
+                            description: "The path to the Markdown file (absolute or relative). REQUIRED if 'content' is not provided.",
                         },
                         theme_id: {
                             type: "string",
                             description: "ID of the theme to use (e.g., default, orangeheart, rainbow, lapis, pie, maize, purple, phycat).",
                         },
                     },
-                    required: ["content"],
                 },
             },
             {
@@ -58,7 +64,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 description: "List the themes compatible with the 'publish_article' tool to publish an article to '微信公众号'.",
                 inputSchema: {
                     type: "object",
-                    properties: {}
+                    properties: {},
                 },
             },
         ],
@@ -74,12 +80,33 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         //     level: "debug",
         //     data: JSON.stringify(request.params.arguments),
         // });
-        const content = String(request.params.arguments?.content || "");
+        const contentArg = request.params.arguments?.content;
+        const fileArg = request.params.arguments?.file;
+        if (!contentArg && !fileArg) {
+            throw new Error("You must provide either 'content' or 'file' to publish an article.");
+        }
+        let content = String(contentArg || "");
+        const file = String(fileArg || "");
         const themeId = String(request.params.arguments?.theme_id || "");
+        let absoluteDirPath;
+        if (!content && file) {
+            const normalizePath = getNormalizeFilePath(file);
+            content = await fs.readFile(normalizePath, "utf-8");
+            if (!content) {
+                throw new Error("Can't read content from the specified file.");
+            }
+            absoluteDirPath = path.dirname(normalizePath);
+        }
         const gzhContent = await getGzhContent(content, themeId, "solarized-light", true, true);
-        const title = gzhContent.title ?? "this is title";
-        const cover = gzhContent.cover ?? "";
-        const response = await publishToDraft(title, gzhContent.content, cover);
+        if (!gzhContent.title) {
+            throw new Error("Can't extract a valid title from the frontmatter.");
+        }
+        if (!gzhContent.cover) {
+            throw new Error("Can't extract a valid cover from the frontmatter or article.");
+        }
+        const response = await publishToDraft(gzhContent.title, gzhContent.content, gzhContent.cover, {
+            relativePath: absoluteDirPath,
+        });
         return {
             content: [
                 {
@@ -95,7 +122,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             text: JSON.stringify({
                 id: theme.id,
                 name: theme.name,
-                description: theme.description
+                description: theme.description,
             }),
         }));
         return {

package/dist/types/utils.d.ts

@@ -0,0 +1 @@
+export declare function getNormalizeFilePath(inputPath: string): string;

package/dist/utils.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+/**
+ * 路径标准化工具函数
+ * 将 Windows 的反斜杠 \ 转换为正斜杠 /，并去除末尾斜杠
+ * 目的：在 Linux 容器内也能正确处理 Windows 路径字符串
+ */
+function normalizePath(p) {
+    return p.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+export function getNormalizeFilePath(inputPath) {
+    const isContainer = !!process.env.CONTAINERIZED;
+    if (isContainer) {
+        const hostFilePath = normalizePath(process.env.HOST_FILE_PATH || "");
+        const containerFilePath = normalizePath(process.env.CONTAINER_FILE_PATH || "/mnt/host-downloads");
+        let relativePart = normalizePath(inputPath);
+        if (relativePart.startsWith(hostFilePath)) {
+            relativePart = relativePart.slice(hostFilePath.length);
+        }
+        if (!relativePart.startsWith("/")) {
+            relativePart = "/" + relativePart;
+        }
+        return containerFilePath + relativePart;
+    }
+    else {
+        return path.resolve(inputPath);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenyan-md/mcp",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "MCP server for Wenyan, a Markdown formatting tool that allows AI assistants to apply elegant built-in themes and publish articles directly to 微信公众号.",
   "author": "Lei <caol64@gmail.com> (https://github.com/caol64)",
   "license": "Apache-2.0",
@@ -36,14 +36,14 @@
   "devDependencies": {
     "@types/node": "^24.3.0",
     "dotenv-cli": "^10.0.0",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4"
+    "openai": "^6.16.0",
+    "typescript": "^5.9.2"
   },
   "scripts": {
     "build": "tsc",
-    "watch": "tsc --watch",
-    "inspector": "pnpm build && pnpm dotenv -e .env.test -- node ./run-inspector.js",
-    "test": "pnpx vitest run",
+    "inspector": "pnpm build && dotenv -e .env.test -- node ./run-inspector.js",
+    "test:list": "pnpm build && dotenv -e .env.test -- node ./test/list.js",
+    "test:publish": "pnpm build && dotenv -e .env.test -- node ./test/publish.js",
     "upgrade:core": "pnpm update @wenyan-md/core"
   }
 }