@wenyan-md/mcp 1.0.2 → 1.0.5

package/README.md

@@ -2,7 +2,14 @@
 
 ![logo](data/wenyan-mcp.png)
 
-## Overview
+「文颜」是一款多平台排版美化工具，让你将 Markdown 一键发布至微信公众号、知乎、今日头条等主流写作平台。
+
+**文颜**现已推出多个版本：
+
+* [macOS App Store 版](https://github.com/caol64/wenyan) - MAC 桌面应用
+* [Windows + Linux 版](https://github.com/caol64/wenyan-pc) - 跨平台桌面应用
+* [CLI 版本](https://github.com/caol64/wenyan-cli) - CI/CD 或脚本自动化发布公众号文章
+* [MCP 版本](https://github.com/caol64/wenyan-mcp) - 让 AI 自动发布公众号文章
 
 文颜 MCP Server 是一个基于模型上下文协议（Model Context Protocol, MCP）的服务器组件，支持将 Markdown 格式的文章发布至微信公众号草稿箱，并使用与 [文颜](https://yuzhi.tech/wenyan) 相同的主题系统进行排版。
 
@@ -12,18 +19,26 @@ https://github.com/user-attachments/assets/2c355f76-f313-48a7-9c31-f0f69e5ec207
 
 - [让AI帮你管理公众号的排版和发布](https://babyno.top/posts/2025/06/let-ai-help-you-manage-your-gzh-layout-and-publishing/)
 
-支持的主题效果预览：
-
-- [内置主题](https://yuzhi.tech/docs/wenyan/theme)
-
-## Features
+## 功能
 
 - 列出并选择支持的文章主题
 - 使用内置主题对 Markdown 内容排版
 - 发布文章到微信公众号草稿箱
 - 自动上传本地或网络图片
 
----
+## 主题效果
+
+👉 [内置主题预览](https://yuzhi.tech/docs/wenyan/theme)
+
+文颜采用了多个开源的 Typora 主题，在此向各位作者表示感谢：
+
+- [Orange Heart](https://github.com/evgo2017/typora-theme-orange-heart)
+- [Rainbow](https://github.com/thezbm/typora-theme-rainbow)
+- [Lapis](https://github.com/YiNNx/typora-theme-lapis)
+- [Pie](https://github.com/kevinzhao2233/typora-theme-pie)
+- [Maize](https://github.com/BEATREE/typora-maize-theme)
+- [Purple](https://github.com/hliu202/typora-purple-theme)
+- [物理猫-薄荷](https://github.com/sumruler/typora-theme-phycat)
 
 ## 使用方式
 
@@ -151,15 +166,11 @@ docker build --build-arg NPM_REGISTRY=https://mirrors.cloud.tencent.com/npm/ -t
 > * `WECHAT_APP_SECRET` 微信平台的 App Secret
 > * `HOST_IMAGE_PATH` 宿主机图片目录
 
----
-
 ## 微信公众号 IP 白名单
 
 请务必将服务器 IP 加入公众号平台的 IP 白名单，以确保上传接口调用成功。
 详细配置说明请参考：[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
 
----
-
 ## 配置说明（Frontmatter）
 
 为了可以正确上传文章，需要在每一篇 Markdown 文章的开头添加一段`frontmatter`，提供`title`、`cover`两个字段：
@@ -177,8 +188,6 @@ cover: /Users/lei/Downloads/result_image.jpg
   * 如果正文有至少一张图片，可省略，此时将使用其中一张作为封面；
   * 如果正文无图片，则必须提供 cover。
 
----
-
 ## 关于图片自动上传
 
 * 支持图片路径：
@@ -186,8 +195,6 @@ cover: /Users/lei/Downloads/result_image.jpg
   * 本地路径（如：`/Users/lei/Downloads/result_image.jpg`）
   * 网络路径（如：`https://example.com/image.jpg`）
 
----
-
 ## 示例文章格式
 
 ```md
@@ -205,8 +212,6 @@ cover: /Users/lei/Downloads/result_image.jpg
 ![](https://mmbiz.qpic.cn/mmbiz_jpg/Jsq9IicjScDVUjkPc6O22ZMvmaZUzof5bLDjMyLg2HeAXd0icTvlqtL7oiarSlOicTtiaiacIxpVOV1EeMKl96PhRPPw/640?wx_fmt=jpeg)
 ```
 
----
-
 ## 如何调试
 
 使用 Inspector 进行简单调试：
@@ -235,14 +240,10 @@ npx @modelcontextprotocol/inspector
 6. 填入参数并点击 Run Tool
 7. 查看完整参数
 
----
-
 ## 赞助
 
 如果您觉得这个项目不错，可以给我家猫咪买点罐头吃。[喂猫❤️](https://yuzhi.tech/sponsor)
 
----
-
 ## License
 
 Apache License Version 2.0

package/dist/index.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * This is a template MCP server that implements a simple notes system.
+ * It demonstrates core MCP concepts like resources and tools by allowing:
+ * - Listing notes as resources
+ * - Reading individual notes
+ * - Creating new notes via a tool
+ * - Summarizing all notes via a prompt
+ */
+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 { getGzhContent } from "@wenyan-md/core/wrapper";
+import { publishToDraft } from "@wenyan-md/core/publish";
+import { themes } from "@wenyan-md/core/theme";
+/**
+ * Create an MCP server with capabilities for resources (to list/read notes),
+ * tools (to create new notes), and prompts (to summarize notes).
+ */
+const server = new Server({
+    name: "wenyan-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        resources: {},
+        tools: {},
+        prompts: {},
+        // logging: {},
+    },
+});
+/**
+ * Handler that lists available tools.
+ * Exposes a single "publish_article" tool that lets clients publish new article.
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "publish_article",
+                description: "Format a Markdown article using a selected theme and publish it to '微信公众号'.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        content: {
+                            type: "string",
+                            description: "The original Markdown content to publish, preserving its frontmatter (if present).",
+                        },
+                        theme_id: {
+                            type: "string",
+                            description: "ID of the theme to use (e.g., default, orangeheart, rainbow, lapis, pie, maize, purple, phycat).",
+                        },
+                    },
+                    required: ["content"],
+                },
+            },
+            {
+                name: "list_themes",
+                description: "List the themes compatible with the 'publish_article' tool to publish an article to '微信公众号'.",
+                inputSchema: {
+                    type: "object",
+                    properties: {}
+                },
+            },
+        ],
+    };
+});
+/**
+ * Handler for the publish_article tool.
+ * Publish a new article with the provided title and content, and returns success message.
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name === "publish_article") {
+        // server.sendLoggingMessage({
+        //     level: "debug",
+        //     data: JSON.stringify(request.params.arguments),
+        // });
+        const content = String(request.params.arguments?.content || "");
+        const themeId = String(request.params.arguments?.theme_id || "");
+        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);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Your article was successfully published to '公众号草稿箱'. The media ID is ${response.media_id}.`,
+                },
+            ],
+        };
+    }
+    else if (request.params.name === "list_themes") {
+        const themeResources = Object.entries(themes).map(([id, theme]) => ({
+            type: "text",
+            text: JSON.stringify({
+                id: theme.id,
+                name: theme.name,
+                description: theme.description
+            }),
+        }));
+        return {
+            content: themeResources,
+        };
+    }
+    throw new Error("Unknown tool");
+});
+/**
+ * Start the server using stdio transport.
+ * This allows the server to communicate via standard input/output streams.
+ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * This is a template MCP server that implements a simple notes system.
+ * It demonstrates core MCP concepts like resources and tools by allowing:
+ * - Listing notes as resources
+ * - Reading individual notes
+ * - Creating new notes via a tool
+ * - Summarizing all notes via a prompt
+ */
+export {};

package/package.json

@@ -1,10 +1,19 @@
 {
   "name": "@wenyan-md/mcp",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "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",
-  "keywords": ["公众号", "markdown", "文颜", "wenyan", "wechat", "publishing", "renderer", "mcp"],
+  "keywords": [
+    "公众号",
+    "markdown",
+    "文颜",
+    "wenyan",
+    "wechat",
+    "publishing",
+    "renderer",
+    "mcp"
+  ],
   "type": "module",
   "bin": {
     "wenyan-mcp": "./dist/index.js"
@@ -12,20 +21,27 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc -b",
-    "watch": "tsc --watch",
-    "inspector": "pnpx @modelcontextprotocol/inspector",
-    "test": "pnpx vitest run",
-    "prepublishOnly": "pnpm build"
+  "homepage": "https://github.com/caol64/wenyan-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caol64/wenyan-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/caol64/wenyan-mcp/issues"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "0.6.0",
-    "@wenyan-md/core": "^1.0.3"
+    "@wenyan-md/core": "^1.0.11"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
     "typescript": "^5.3.3",
     "vitest": "^3.2.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "inspector": "pnpm build && node ./run-inspector.js",
+    "test": "pnpx vitest run"
   }
-}
+}