文颜MCP Server

文颜 MCP Server

概要

文颜（Wenyan） は、複数のプラットフォームに対応した Markdown 組版・公開ツールです。Markdown をワンクリックで変換し、次のプラットフォームに公開できます。

• WeChat 公式アカウント
• Zhihu
• 今日頭条
• その他のコンテンツプラットフォーム（順次拡大中）

文颜の目標は、執筆者が組版やプラットフォームへの適応ではなく、コンテンツに集中できるようにすることです。

文颜の各バージョン

文颜は現在、さまざまな利用シーンに対応する複数の形態を提供しています。

• macOS App Store 版 - Mac デスクトップアプリ
• クロスプラットフォームデスクトップ版 - Windows/Linux
• CLI 版 - コマンドライン／CI による自動公開
• 👉 MCP 版 - 本プロジェクト

文颜 MCP Server とは？

簡単に言うと、「AI による執筆」と「公式アカウントへの記事投稿」をつなぐものです。

MCP プロトコルに基づき、Claude Desktop などの AI クライアントから、文颜（Wenyan）の組版エンジンを直接呼び出せるようになります。記事を書いた後、サードパーティのエディターで何度もコピー＆ペーストする必要はありません。AI に組版を任せ、そのまま WeChat の下書きに保存できます。

主な機能：

• 組版ツールを介さずに公開：AI が生成した Markdown を WeChat のリッチテキストに直接変換してアップロードするため、中間の手順を省けます。
• 会話形式で組版：AI に「オレンジ色のテーマに変えて」と入力するだけで、スタイルが自動的に適用されます。
• 画面を切り替えずに一連の作業を完了：同じチャット画面で、「テーマを決める -> 記事を書く -> 組版を調整する -> 下書きに保存する」まで、すべてスムーズに実行できます。

実例：

• AI に公式アカウントの組版と公開を任せる
• Moraya MCP の使用例：WeChat 公式アカウントの全面管理

機能

• Markdown をワンクリックで WeChat 公式アカウントの下書きに公開
• ローカル画像とカバー画像を自動アップロード
• リモートサーバーからの公開に対応（IP ホワイトリストの制限を回避）
• 美しい組版テーマを複数内蔵
• カスタムテーマに対応
• 標準 MCP ツールインターフェースを提供
• 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 テーマを使って、この記事を WeChat 公式アカウントに公開してください：./tests/publish.md

AI の応答：

文章已成功发布至微信公众号草稿箱！🎉

- **主题**：phycat  
- **媒体ID**：xxx

您可登录微信公众号后台，在「草稿箱」中查看并编辑文章，确认无误后即可一键发布。如需进一步排版优化、添加封面或设置摘要，我也可以协助您完成！

是否需要我帮您生成一篇发布文案或封面建议？ 😊

概念

環境変数の設定

重要

MCP の起動時に、以下の環境変数が設定されていることを確認してください。設定されていない場合、アップロード API の呼び出しに失敗します。

• WECHAT_APP_ID
• WECHAT_APP_SECRET

WeChat 公式アカウントの IP ホワイトリスト

重要

文颜を実行するマシンの IP が WeChat 公式アカウント管理画面の IP ホワイトリストに追加されていることを確認してください。追加されていない場合、アップロード API の呼び出しに失敗します。

設定手順のドキュメント：https://yuzhi.tech/docs/wenyan/upload

記事の形式

記事を正しくアップロードするには、各 Markdown ファイルの先頭に frontmatter を含める必要があります。

---
title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
cover: /Users/xxx/image.jpg
author: xxx
source_url: http://
---

フィールドの説明：

フィールド	必須	説明
title	✅	記事のタイトル
cover	❌	カバー画像（ローカルパスまたはネットワーク URL）
author	❌	著者
source_url	❌	元記事のリンク
type	❌	記事の種類。image に設定すると画像メッセージ（小绿书）になります
image_list	❌	画像パスの一覧（小绿书専用、最大 20 枚）
need_open_comment	❌	コメントを有効にするかどうか
only_fans_can_comment	❌	ファンのみコメントできるようにするかどうか

説明：

• cover を指定しない場合、本文の最初の画像がカバーとして自動的に使用されます
• cover にはローカルパスとネットワーク URL を指定できます
• type と image_list は画像メッセージの公開に使用します

記事の例

記事内の画像とカバー画像

公式アカウントに記事を公開する前に、文颜は WeChat の要件に従って記事内のすべての画像を自動的に処理し、公式アカウントの素材ライブラリにアップロードします。現在、文颜は次の形式の画像に対応しています。

• ローカルディスクの絶対パス（例：/Users/xxx/image.jpg）
• ネットワークパス（例：https://example.com/image.jpg）
• 記事からの相対パス（例：./assets/image.png）

画像メッセージ（小绿书）の公開

画像メッセージの公開は、記事と画像を組み合わせたメッセージの公開と異なり、frontmatter に画像一覧を指定する必要があります。次の 2 つの方法に対応しています。

方法 1：type: image を使用（推奨）

frontmatter で type: image を設定すると、CLI が本文からすべての画像を自動的に抽出します。

---
title: 人勤春来早，读书正当时
type: image
---

![](./1.jpeg)
![](./2.jpeg)
![](./3.jpeg)

方法 2：image_list を手動で指定

frontmatter に画像パスを直接列挙します。

---
title: 人勤春来早，读书正当时
image_list:
  - ./1.jpeg
  - ./2.jpeg
  - ./3.jpeg
  - ./4.jpeg
  - ./5.jpeg
---

image_list は最大 20 枚まで指定でき、最初の画像がカバーになります。

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 自动发布

Server 模式部署

Claude Desktop 配置：：

{
  "mcpServers": {
    "wenyan-mcp": {
      "command": "wenyan-mcp",
      "args": ["--server", "https://api.example.com", "--api-key", "your-api-key"]
    }
  }
}

多公众号发布（进阶）

重要

必须使用server模式才能使用多公众号发布功能。

步骤：

• 首先部署server
• 在server端配置多个微信凭据，参考文档
• 让MCP 客户端连接server

对AI说

使用phycat主题将这篇文章发布到微信公众号(your_app_id)：./tests/publish.md

Docker 部署

适合不希望安装 Node.js 环境的用户。

docker pull caol64/wenyan-mcp:latest

• Claude Desktop 配置：：

{
  "mcpServers": {
    "wenyan-mcp": {
      "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 会自动将其映射，使容器能够读取并上传。

如何调试

推荐使用官方 Inspector 进行调试：

npx @modelcontextprotocol/inspector <command>

启动成功出现类似提示：

🔗 Open inspector with token pre-filled:
   http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=761c05058aa4f84ad02280e62d7a7e52ec0430d00c4c7a61492cca59f9eac299
   (Auto-open is disabled when authentication is enabled)

访问以上链接即可打开调试页面。

1. 正确填写启动命令
2. 添加环境变量
3. 点击 Connect
4. 选择 Tools -> List Tools
5. 选择要调试的接口
6. 填入参数并点击 Run Tool
7. 查看完整参数

赞助

如果你觉得文颜对你有帮助，可以给我家猫咪买点罐头 ❤️

https://yuzhi.tech/sponsor

License

Apache License Version 2.0