Skip to content
Back to search

wenyan-mcp

文颜 MCP Server 可以让 AI 自动将 Markdown 文章排版后发布至微信公众号。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/caol64--wenyan-mcp/badge.svg)](/listings/caol64--wenyan-mcp)

HTML

<a href="/listings/caol64--wenyan-mcp"><img src="/api/listings/caol64--wenyan-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 380 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img alt="logo" src="https://media.githubusercontent.com/media/caol64/wenyan-mcp/main/data/wenyan-mcp.png" width="256" />
  3. </div>
  4. # 文颜 MCP Server
  5. [![npm](https://img.shields.io/npm/v/@wenyan-md/mcp)](https://www.npmjs.com/package/@wenyan-md/mcp)
  6. [![License](https://img.shields.io/github/license/caol64/wenyan-mcp)](LICENSE)
  7. ![NPM Downloads](https://img.shields.io/npm/dm/%40wenyan-md%2Fmcp)
  8. [![Docker Pulls](https://img.shields.io/docker/pulls/caol64/wenyan-mcp)](https://hub.docker.com/r/caol64/wenyan-mcp)
  9. [![Stars](https://img.shields.io/github/stars/caol64/wenyan-mcp?style=social)](https://github.com/caol64/wenyan-mcp)
  10. ## 简介
  11. **[文颜(Wenyan)](https://wenyan.yuzhi.tech)** 是一款多平台 Markdown 排版与发布工具,支持将 Markdown 一键转换并发布至:
  12. - 微信公众号
  13. - 知乎
  14. - 今日头条
  15. - 以及其它内容平台(持续扩展中)
  16. 文颜的目标是:**让写作者专注内容,而不是排版和平台适配**。
  17. ## 文颜的不同版本
  18. 文颜目前提供多种形态,覆盖不同使用场景:
  19. - [macOS App Store 版](https://github.com/caol64/wenyan) - MAC 桌面应用
  20. - [跨平台桌面版](https://github.com/caol64/wenyan-pc) - Windows/Linux
  21. - [CLI 版本](https://github.com/caol64/wenyan-cli) - 命令行 / CI 自动化发布
  22. - 👉 [MCP 版本](https://github.com/caol64/wenyan-mcp) - 本项目
  23. ## 文颜 MCP Server 是什么?
  24. 简单来说,它打通了“AI 写作”与“公众号发文”的通道。
  25. 基于 MCP 协议,Claude Desktop 等 AI 客户端现在可以直接调用文颜(Wenyan)的排版引擎。写完文章后,不需要再去第三方编辑器里来回复制粘贴,直接让 AI 帮你排版并塞进微信草稿箱。
  26. **核心特性:**
  27. - **绕过排版工具**:AI 生成的 Markdown 直接转成微信富文本并上传,省去中间步骤。
  28. - **对话式排版**:直接打字跟 AI 说“换个橙色风格主题”,样式自动生效。
  29. - **不出窗口完成闭环**:在同一个聊天框里,顺滑搞定“想选题 -> 写文章 -> 调排版 -> 存草稿”的所有操作。
  30. **实战演示**:
  31. * [让 AI 帮你管理公众号的排版和发布](https://babyno.top/posts/2025/06/let-ai-help-you-manage-your-gzh-layout-and-publishing/)
  32. * [Moraya MCP 使用案例:微信公众号全托管](https://github.com/zouwei/moraya/wiki/Moraya-MCP-%E4%BD%BF%E7%94%A8%E6%A1%88%E4%BE%8B%EF%BC%9A%E5%BE%AE%E4%BF%A1%E5%85%AC%E4%BC%97%E5%8F%B7%E5%85%A8%E6%89%98%E7%AE%A1)
  33. ## 功能特性
  34. - 一键发布 Markdown 到微信公众号草稿箱
  35. - 自动上传本地图片与封面
  36. - 支持远程 Server 发布(绕过 IP 白名单限制)
  37. - 内置多套精美排版主题
  38. - 支持自定义主题
  39. - 提供标准 MCP Tool 接口
  40. - 支持 AI 自动调用:
  41. - 渲染 Markdown
  42. - 主题管理
  43. - 发布草稿
  44. ## 快速开始
  45. **安装**
  46. ```bash
  47. npm install -g @wenyan-md/mcp
  48. ```
  49. **Claude Desktop 配置 (claude_desktop_config.json):**:
  50. ```json
  51. {
  52. "mcpServers": {
  53. "wenyan-mcp": {
  54. "command": "wenyan-mcp",
  55. "env": {
  56. "WECHAT_APP_ID": "your_app_id",
  57. "WECHAT_APP_SECRET": "your_app_secret"
  58. }
  59. }
  60. }
  61. }
  62. ```
  63. ## 基本用法
  64. ### 列出主题
  65. 对AI说
  66. > 目前你可以使用哪些公众号主题?
  67. AI回复:
  68. ```
  69. 目前我支持的公众号主题包括以下这些,每个主题都有独特的风格和配色,适用于不同的内容调性:
  70. 1. **Default(默认)**
  71. 简洁经典的排版,适合长文阅读,通用性强。
  72. 2. **OrangeHeart(橙心)**
  73. 暖橙色调,优雅而富有活力,适合情感、生活类内容。
  74. ...
  75. ```
  76. ### 注册主题
  77. 对AI说
  78. > 帮我把这个css(https://wenyan.yuzhi.tech/manhua.css)注册为一个新的公众号主题,名称为:xiuluochang
  79. AI回复:
  80. ```
  81. 好的,已成功将 CSS 样式表注册为新的公众号主题,主题名称为:**xiuluochang**。
  82. 您现在可以在公众号后台选择该主题进行应用,样式将按照 `https://wenyan.yuzhi.tech/manhua.css` 的定义进行渲染。
  83. 如有需要进一步自定义或更换主题,随时告诉我!
  84. ```
  85. ### 删除主题
  86. 对AI说
  87. > 把名为“xiuluochang”的公众号主题删除
  88. AI回复:
  89. ```
  90. 公众号主题 “xiuluochang” 已成功删除。
  91. ```
  92. ### 发布文章
  93. 对AI说
  94. > 使用phycat主题将这篇文章发布到微信公众号:`./tests/publish.md`
  95. AI回复:
  96. ```
  97. 文章已成功发布至微信公众号草稿箱!🎉
  98. - **主题**:phycat
  99. - **媒体ID**:xxx
  100. 您可登录微信公众号后台,在「草稿箱」中查看并编辑文章,确认无误后即可一键发布。如需进一步排版优化、添加封面或设置摘要,我也可以协助您完成!
  101. 是否需要我帮您生成一篇发布文案或封面建议? 😊
  102. ```
  103. ## 概念
  104. ### 环境变量配置
  105. > [!IMPORTANT]
  106. >
  107. > 请确保 MCP 启动时已配置如下环境变量,否则上传接口将调用失败。
  108. - `WECHAT_APP_ID`
  109. - `WECHAT_APP_SECRET`
  110. ### 微信公众号 IP 白名单
  111. > [!IMPORTANT]
  112. >
  113. > 请确保运行文颜的机器 IP 已加入微信公众号后台的 IP 白名单,否则上传接口将调用失败。
  114. 配置说明文档:[https://yuzhi.tech/docs/wenyan/upload](https://yuzhi.tech/docs/wenyan/upload)
  115. ### 文章格式
  116. 为了正确上传文章,每篇 Markdown 顶部需要包含一段 `frontmatter`:
  117. ```md
  118. ---
  119. title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
  120. cover: /Users/xxx/image.jpg
  121. author: xxx
  122. source_url: http://
  123. ---
  124. ```
  125. 字段说明:
  126. | 字段 | 必填 | 说明 |
  127. | ---------- | -- | ----------------- |
  128. | title | ✅ | 文章标题 |
  129. | cover | ❌ | 封面图片(本地路径或网络 URL) |
  130. | author | ❌ | 作者 |
  131. | source_url | ❌ | 原文链接 |
  132. | type | ❌ | 文章类型,设为 `image` 表示图片消息(小绿书) |
  133. | image_list | ❌ | 图片路径列表(小绿书专用,最多 20 张) |
  134. | need_open_comment | ❌ | 是否打开评论 |
  135. | only_fans_can_comment | ❌ | 是否仅粉丝可评论 |
  136. 说明:
  137. * 如果未指定 cover,将自动使用正文第一张图片作为封面
  138. * cover 支持本地路径和网络 URL
  139. * `type` 和 `image_list` 用于图片消息发布
  140. **[示例文章](tests/publish.md)**
  141. ### 文内图片和文章封面
  142. 把文章发布到公众号之前,文颜会按照微信要求自动处理文章内的所有图片,将其上传到公众号素材库。目前文颜对于以下图片都能很好的支持:
  143. - 本地硬盘绝对路径(如:`/Users/xxx/image.jpg`)
  144. - 网络路径(如:`https://example.com/image.jpg`)
  145. - 当前文章的相对路径(如:`./assets/image.png`)
  146. ## 发布图片消息(小绿书)
  147. 发布图片消息与发布图文消息的区别在于 frontmatter 中需要指定图片列表。支持两种方式:
  148. ### 方式一:使用 type: image(推荐)
  149. 在 frontmatter 中设置 `type: image`,CLI 会自动从正文中提取所有图片:
  150. ```md
  151. ---
  152. title: 人勤春来早,读书正当时
  153. type: image
  154. ---
  155. ![](./1.jpeg)
  156. ![](./2.jpeg)
  157. ![](./3.jpeg)
  158. ```
  159. ### 方式二:手动指定 image_list
  160. 直接在 frontmatter 中列出图片路径:
  161. ```md
  162. ---
  163. title: 人勤春来早,读书正当时
  164. image_list:
  165. - ./1.jpeg
  166. - ./2.jpeg
  167. - ./3.jpeg
  168. - ./4.jpeg
  169. - ./5.jpeg
  170. ---
  171. ```
  172. `image_list` 最多 20 张,首张即为封面。
  173. ## Server 模式
  174. 相较于纯本地运行的**本地模式(Stdio Mode)**,`wenyan-mcp`还提供了 **远程客户端模式(Client–Server Mode)**。两种模式运行效果完全一致,你可以根据运行环境和网络条件选择最合适的方式。
  175. 在本地模式下,MCP 直接调用微信公众号 API 完成图片上传和草稿发布。
  176. ```mermaid
  177. flowchart LR
  178. MCP[Wenyan MCP] --> Wechat[公众号 API]
  179. ```
  180. 在远程客户端模式下,MCP 作为客户端,将发布请求发送到部署在云服务器上的 Wenyan Server,由 Server 完成微信公众号 API 调用。
  181. ```mermaid
  182. flowchart LR
  183. MCP[Wenyan MCP] --> Server[Wenyan Server] --> Wechat[公众号 API]
  184. ```
  185. **适用于:**
  186. * 无本地固定 IP,需频繁添加IP 白名单的用户
  187. * 需团队协作的用户
  188. * 支持 CI/CD 自动发布
  189. * 支持 AI Agent 自动发布
  190. **[Server 模式部署](https://github.com/caol64/wenyan-cli/blob/main/docs/server.md)**
  191. **Claude Desktop 配置:**:
  192. ```json
  193. {
  194. "mcpServers": {
  195. "wenyan-mcp": {
  196. "command": "wenyan-mcp",
  197. "args": ["--server", "https://api.example.com", "--api-key", "your-api-key"]
  198. }
  199. }
  200. }
  201. ```
  202. ## 多公众号发布(进阶)
  203. > [!IMPORTANT]
  204. >
  205. > 必须使用`server`模式才能使用多公众号发布功能。
  206. 步骤:
  207. - 首先部署`server`
  208. - 在`server`端配置多个微信凭据,参考[文档](https://github.com/caol64/wenyan-cli)
  209. - 让`MCP 客户端`连接`server`
  210. 对AI说
  211. > 使用phycat主题将这篇文章发布到微信公众号(your_app_id):`./tests/publish.md`
  212. ## Docker 部署
  213. 适合不希望安装 Node.js 环境的用户。
  214. ```bash
  215. docker pull caol64/wenyan-mcp:latest
  216. ```
  217. * **Claude Desktop 配置:**:
  218. ```json
  219. {
  220. "mcpServers": {
  221. "wenyan-mcp": {
  222. "command": "docker",
  223. "args": [
  224. "run",
  225. "--rm",
  226. "-i",
  227. "-v", "/your/host/file/path:/mnt/host-downloads",
  228. "-e", "WECHAT_APP_ID=your_app_id",
  229. "-e", "WECHAT_APP_SECRET=your_app_secret",
  230. "-e", "HOST_FILE_PATH=/your/host/file/path",
  231. "caol64/wenyan-mcp"
  232. ]
  233. }
  234. }
  235. }
  236. ```
  237. > **Docker 配置特别说明:**
  238. >
  239. > * **挂载目录 (`-v`)**:必须将宿主机的文件/图片目录挂载到容器内的 `/mnt/host-downloads`。
  240. > * **环境变量 (`HOST_FILE_PATH`)**:必须与宿主机挂载的文件/图片目录路径保持一致。
  241. > * **原理**:你的 Markdown 文件/文章内所引用的本地图片应放置在该目录中,Docker 会自动将其映射,使容器能够读取并上传。
  242. ## 如何调试
  243. 推荐使用官方 Inspector 进行调试:
  244. ```bash
  245. npx @modelcontextprotocol/inspector <command>
  246. ```
  247. 启动成功出现类似提示:
  248. ```bash
  249. 🔗 Open inspector with token pre-filled:
  250. http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=761c05058aa4f84ad02280e62d7a7e52ec0430d00c4c7a61492cca59f9eac299
  251. (Auto-open is disabled when authentication is enabled)
  252. ```
  253. 访问以上链接即可打开调试页面。
  254. ![debug](data/1.jpg)
  255. 1. 正确填写启动命令
  256. 2. 添加环境变量
  257. 3. 点击 Connect
  258. 4. 选择 Tools -> List Tools
  259. 5. 选择要调试的接口
  260. 6. 填入参数并点击 Run Tool
  261. 7. 查看完整参数
  262. ## 赞助
  263. 如果你觉得文颜对你有帮助,可以给我家猫咪买点罐头 ❤️
  264. [https://yuzhi.tech/sponsor](https://yuzhi.tech/sponsor)
  265. ## License
  266. Apache License Version 2.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.