<div align="center"> <img alt = "logo" src="https://media.githubusercontent.com/media/caol64/wenyan-mcp/main/data/wenyan-mcp.png" /> </div>

文颜 MCP Server

简介

文颜（Wenyan） 是一款多平台 Markdown 排版与发布工具，支持将 Markdown 一键转换并发布至：

• 微信公众号
• 知乎
• 今日头条
• 以及其它内容平台（持续扩展中）

文颜的目标是：让写作者专注内容，而不是排版和平台适配。

文颜的不同版本

文颜目前提供多种形态，覆盖不同使用场景：

• macOS App Store 版 - MAC 桌面应用
• 跨平台桌面版 - Windows/Linux
• CLI 版本 - 命令行 / CI 自动化发布
• 👉 MCP 版本 - 本项目
• 核心库 - 嵌入 Node / Web 项目

本仓库是 文颜的 MCP Server 版本，基于模型上下文协议（Model Context Protocol），旨在让 AI 助手（如 Claude Desktop）具备自动排版和发布公众号文章的能力。

• 与 AI 深度集成：让 AI 帮你管理公众号的排版和发布

<video src="https://github.com/user-attachments/assets/2c355f76-f313-48a7-9c31-f0f69e5ec207"></video>

[!TIP]

如果与 AI 集成遇到问题，可以参考 test/list.js 和 test/publish.js 中的完整调用示例。

安装与集成

文颜 MCP Server 支持多种运行方式，请根据你的环境选择。

方式一：npm 安装（推荐）

直接安装到本地：

npm install -g @wenyan-md/mcp

配置 MCP Client（如 Claude Desktop）：

在你的 MCP 配置文件中加入以下内容：

{
  "mcpServers": {
    "wenyan-mcp": {
      "name": "公众号助手",
      "command": "wenyan-mcp",
      "env": {
        "WECHAT_APP_ID": "your_app_id",
        "WECHAT_APP_SECRET": "your_app_secret"
      }
    }
  }
}

方式二：Docker 运行（推荐）

适合部署到服务器环境，或希望环境隔离的用户。

拉取镜像：

docker pull caol64/wenyan-mcp

配置 MCP Client：

{
  "mcpServers": {
    "wenyan-mcp": {
      "name": "公众号助手",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v", "/your/host/file/path:/mnt/host-downloads",
        "-e", "WECHAT_APP_ID=your_app_id",
        "-e", "WECHAT_APP_SECRET=your_app_secret",
        "-e", "HOST_FILE_PATH=/your/host/file/path",
        "caol64/wenyan-mcp"
      ]
    }
  }
}

Docker 配置特别说明：

• 挂载目录 (-v)：必须将宿主机的文件/图片目录挂载到容器内的 /mnt/host-downloads。
• 环境变量 (HOST_FILE_PATH)：必须与宿主机挂载的文件/图片目录路径保持一致。
• 原理：你的 Markdown 文件/文章内所引用的本地图片应放置在该目录中，Docker 会自动将其映射，使容器能够读取并上传。

基本用法

列出主题

对AI说

目前你可以使用哪些公众号主题？

AI回复：

目前我支持的公众号主题包括以下这些，每个主题都有独特的风格和配色，适用于不同的内容调性：

1. **Default（默认）**  
   简洁经典的排版，适合长文阅读，通用性强。

2. **OrangeHeart（橙心）**  
   暖橙色调，优雅而富有活力，适合情感、生活类内容。
...

注册主题

...