文颜 (Wenyan) MCP Server

概要

文颜 (Wenyan) は、マルチプラットフォーム対応のMarkdown組版・投稿ツールです。Markdownをワンクリックで変換し、以下のプラットフォームへ投稿できます：

• WeChat公式アカウント

• 知乎 (Zhihu)

• 今日頭条 (Toutiao)

• その他コンテンツプラットフォーム（順次拡大中）

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

Related MCP server: WeChat Article MCP Server

文颜の各バージョン

文颜は現在、さまざまな利用シーンに対応した形態を提供しています：

• macOS App Store版 - Macデスクトップアプリ

• クロスプラットフォームデスクトップ版 - Windows/Linux

• CLI版 - コマンドライン / CI自動投稿

• 👉 MCP版 - 本プロジェクト

文颜 MCP Server とは？

簡単に言えば、「AIライティング」と「WeChat公式アカウントへの投稿」をつなぐパイプラインです。

MCPプロトコルに基づき、Claude DesktopなどのAIクライアントから直接文颜の組版エンジンを呼び出せます。記事を書き終えた後、サードパーティのエディタにコピー＆ペーストする必要はありません。AIに組版を依頼し、そのままWeChatのドラフトボックスへ保存できます。

主な特徴：

• 組版ツールをバイパス：AIが生成したMarkdownを直接WeChat用のリッチテキストに変換してアップロードするため、中間ステップを省略できます。

• 会話型組版：AIに「オレンジ系のスタイルテーマに変えて」と伝えるだけで、スタイルが自動的に適用されます。

• ウィンドウを閉じずに完結：同じチャット画面内で「トピック選定 -> 執筆 -> 組版調整 -> ドラフト保存」の全操作をスムーズに行えます。

実践デモ：

• AIにWeChat公式アカウントの組版と投稿を管理させる

• Moraya MCP 使用例：WeChat公式アカウントのフルマネージド運用

機能特性

• MarkdownをワンクリックでWeChat公式アカウントのドラフトボックスへ投稿

• ローカル画像とカバー画像の自動アップロード

• リモートサーバー経由の投稿をサポート（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テーマを使用して、この記事をWeChat公式アカウントに投稿してください：./tests/publish.md

AIの回答：

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

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

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

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

コンセプト

環境変数の設定

[!IMPORTANT]

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

• WECHAT_APP_ID

• WECHAT_APP_SECRET

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

[!IMPORTANT]

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

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

記事フォーマット

記事を正しくアップロードするために、各Markdownの先頭に frontmatter を含める必要があります：

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

フィールドの説明：

説明：

• coverが指定されていない場合、本文の最初の画像が自動的にカバーとして使用されます。

• coverはローカルパスとWeb URLの両方をサポートしています。

• type と image_list は画像メッセージ投稿用です。

記事サンプル

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

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

• ローカルディスクの絶対パス（例：/Users/xxx/image.jpg）

• Webパス（例：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枚までで、最初の画像がカバーになります。

サーバーモード

ローカルのみで動作する**ローカルモード（Stdio Mode）**に対し、wenyan-mcp は **リモートクライアントモード（Client–Server Mode）**も提供しています。どちらのモードでも動作結果は完全に同じであり、実行環境やネットワーク条件に応じて最適な方法を選択できます。

ローカルモードでは、MCPが直接WeChat公式アカウントAPIを呼び出して画像のアップロードとドラフト投稿を完了します。

flowchart LR
    MCP[Wenyan MCP] --> Wechat[公众号 API]

リモートクライアントモードでは、MCPがクライアントとして機能し、クラウドサーバー上にデプロイされたWenyan Serverに投稿リクエストを送信し、サーバー側でWeChat公式アカウントAPIの呼び出しを行います。

flowchart LR
    MCP[Wenyan MCP] --> Server[Wenyan Server] --> Wechat[公众号 API]

以下のような場合に適しています：

• ローカルに固定IPがなく、頻繁にIPホワイトリストを追加する必要があるユーザー

• チームで共同作業を行うユーザー

• CI/CDによる自動投稿をサポートしたい場合

• AIエージェントによる自動投稿をサポートしたい場合

サーバーモードのデプロイ

Claude Desktop 設定：：

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

マルチアカウント投稿（上級者向け）

[!IMPORTANT]

マルチアカウント投稿機能を使用するには、serverモードが必須です。

手順：

• まず server をデプロイします。

• server 側で複数のWeChat認証情報を設定します（ドキュメントを参照）。

• MCPクライアント を server に接続します。

AIに以下のように伝えます：

phycatテーマを使用して、この記事をWeChat公式アカウント(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

ライセンス

Apache License Version 2.0