Bridge AI writing and WeChat Official Account publishing with Markdown.
文颜 MCP Server
简介
文颜（Wenyan） 是一款多平台 Markdown 排版与发布工具，支持将 Markdown 一键转换并发布至：
- 微信公众号
- 知乎
- 今日头条
- 以及其它内容平台（持续扩展中）
文颜的目标是：让写作者专注内容，而不是排版和平台适配。
文颜的不同版本
文颜目前提供多种形态，覆盖不同使用场景：
- macOS App Store 版 - MAC 桌面应用
- 跨平台桌面版 - Windows/Linux
- CLI 版本 - 命令行 / CI 自动化发布
- 👉 MCP 版本 - 本项目
文颜 MCP Server 是什么？
简单来说，它打通了“AI 写作”与“公众号发文”的通道。
基于 MCP 协议，Claude Desktop 等 AI 客户端现在可以直接调用文颜（Wenyan）的排版引擎。写完文章后，不需要再去第三方编辑器里来回复制粘贴，直接让 AI 帮你排版并塞进微信草稿箱。
核心特性：
- 绕过排版工具：AI 生成的 Markdown 直接转成微信富文本并上传，省去中间步骤。
- 对话式排版：直接打字跟 AI 说“换个橙色风格主题”，样式自动生效。
- 不出窗口完成闭环：在同一个聊天框里，顺滑搞定“想选题 -> 写文章 -> 调排版 -> 存草稿”的所有操作。
实战演示：
功能特性
- 一键发布 Markdown 到微信公众号草稿箱
- 自动上传本地图片与封面
- 支持远程 Server 发布（绕过 IP 白名单限制）
- 内置多套精美排版主题
- 支持自定义主题
- 提供标准 MCP Tool 接口
- 支持 AI 自动调用：
- 渲染 Markdown
- 主题管理
- 发布草稿
快速开始
安装
npm install -g @wenyan-md/mcp
Claude Desktop 配置 (claude_desktop_config.json)：：
{
"mcpServers": {
"wenyan-mcp": {
"command": "wenyan-mcp",
"env": {
"WECHAT_APP_ID": "your_app_id",
"WECHAT_APP_SECRET": "your_app_secret"
}
}
}
}
基本用法
列出主题
对AI说
目前你可以使用哪些公众号主题？
AI回复：
目前我支持的公众号主题包括以下这些，每个主题都有独特的风格和配色，适用于不同的内容调性：
1. **Default（默认）**
简洁经典的排版，适合长文阅读，通用性强。
2. **OrangeHeart（橙心）**
暖橙色调，优雅而富有活力，适合情感、生活类内容。
...
注册主题
对AI说
帮我把这个css(https://wenyan.yuzhi.tech/manhua.css)注册为一个新的公众号主题，名称为：xiuluochang
AI回复：
好的，已成功将 CSS 样式表注册为新的公众号主题，主题名称为：**xiuluochang**。
您现在可以在公众号后台选择该主题进行应用，样式将按照 `https://wenyan.yuzhi.tech/manhua.css` 的定义进行渲染。
如有需要进一步自定义或更换主题，随时告诉我！
删除主题
对AI说
把名为“xiuluochang”的公众号主题删除
AI回复：
公众号主题 “xiuluochang” 已成功删除。
发布文章
对AI说
使用phycat主题将这篇文章发布到微信公众号：
./tests/publish.md
AI回复：
文章已成功发布至微信公众号草稿箱！🎉
- **主题**：phycat
- **媒体ID**：xxx
您可登录微信公众号后台，在「草稿箱」中查看并编辑文章，确认无误后即可一键发布。如需进一步排版优化、添加封面或设置摘要，我也可以协助您完成！
是否需要我帮您生成一篇发布文案或封面建议？ 😊
概念
环境变量配置
[!IMPORTANT]
请确保 MCP 启动时已配置如下环境变量，否则上传接口将调用失败。
WECHAT_APP_IDWECHAT_APP_SECRET
微信公众号 IP 白名单
[!IMPORTANT]
请确保运行文颜的机器 IP 已加入微信公众号后台的 IP 白名单，否则上传接口将调用失败。
配置说明文档：https://yuzhi.tech/docs/wenyan/upload
文章格式
为了正确上传文章，每篇 Markdown 顶部需要包含一段 frontmatter：
---
title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
cover: /Users/xxx/image.jpg
author: xxx
source_url: http://
---
字段说明：
title文章标题（必填）cover文章封面- 本地路径或网络图片
- 如果正文中已有图片，可省略
author文章作者source_url原文地址
文内图片和文章封面
把文章发布到公众号之前，文颜会按照微信要求自动处理文章内的所有图片，将其上传到公众号素材库。目前文颜对于以下图片都能很好的支持：
- 本地硬盘绝对路径（如：
/Users/xxx/image.jpg） - 网络路径（如：
https://example.com/image.jpg） - 当前文章的相对路径（如：
./assets/image.png）
Server 模式
相较于纯本地运行的本地模式（Stdio Mode），wenyan-mcp还提供了 远程客户端模式（Client–Server Mode）。两种模式运行效果完全一致，你可以根据运行环境和网络条件选择最合适的方式。
在本地模式下，MCP 直接调用微信公众号 API 完成图片上传和草稿发布。
flowchart LR
MCP[Wenyan MCP] --> Wechat[公众号 API]
在远程客户端模式下，MCP 作为客户端，将发布请求发送到部署在云服务器上的 Wenyan Server，由 Server 完成微信公众号 API 调用。
flowchart LR
MCP[Wenyan MCP] --> Server[Wenyan Server] --> Wechat[公众号 API]
适用于：
- 无本地固定 IP，需频繁添加IP 白名单的用户
- 需团队协作的用户
- 支持 CI/CD 自动发布
- 支持 AI Agent 自动发布
Claude Desktop 配置：：
{
"mcpServers": {
"wenyan-mcp": {
"command": "wenyan-mcp",
"args": ["--server", "https://api.example.com", "--api-key", "your-api-key"]
"env": {
"WECHAT_APP_ID": "your_app_id",
"WECHAT_APP_SECRET": "your_app_secret"
}
}
}
}
Docker 部署
适合不希望安装 Node.js 环境的用户。
docker pull caol64/wenyan-mcp:latest
- Claude Desktop 配置：：
{
"mcpServers": {
"wenyan-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"
Tools (3)
render_markdownRenders Markdown content into WeChat-compatible rich text format.manage_themesList, register, or delete WeChat article themes.publish_draftPublishes a Markdown file to the WeChat Official Account draft box.Environment Variables
WECHAT_APP_IDrequiredThe App ID for your WeChat Official Account.WECHAT_APP_SECRETrequiredThe App Secret for your WeChat Official Account.Configuration
{"mcpServers": {"wenyan-mcp": {"command": "wenyan-mcp", "env": {"WECHAT_APP_ID": "your_app_id", "WECHAT_APP_SECRET": "your_app_secret"}}}}