wenyan

Wenyan MCP Server provides an MCP-compliant gateway that lets AI clients interact with Wenyan’s publishing pipeline to format Markdown and publish to WeChat. The server exposes tools for rendering Markdown into WeChat-ready rich text, uploading local images, managing themes, and publishing drafts. It also supports remote server mode, where the MCP acts as a client and forwards requests to a Wenyan Server deployed remotely, enabling CI/CD or team collaboration workflows. Typical usage is to run the Wenyan MCP server locally (or via Docker) and configure Claude Desktop or other MCP-compatible clients to talk to it, leveraging standard MCP Tool interfaces to list themes, register custom themes, publish articles, and adjust typography. Tools available include rendering Markdown, theme management, publish pipelines, image handling, and AI-assisted formatting commands.

Prerequisites:

• Node.js and npm installed on your machine (or Docker if you prefer containerized deployment).
• Access to a WeChat Official Account and its App ID/Secret for uploading content.

Install methods:

Option 1: Global Node.js installation

npm install -g @wenyan-md/mcp

Run the server (example):

wenyan-mcp

Option 2: Docker deployment (no Node.js install required)

docker pull caol64/wenyan-mcp:latest

Run with environment variables (example):

docker run --rm -i \
  -e WECHAT_APP_ID=your_app_id \
  -e WECHAT_APP_SECRET=your_app_secret \
  -v /path/to/your/content:/mnt/content \
  caol64/wenyan-mcp

Option 3: Using npm via project, if you prefer project-local use

npx @wenyan-md/mcp

Notes:

• Ensure you configure WECHAT_APP_ID and WECHAT_APP_SECRET as needed for authentication with WeChat APIs.
• When using Docker, mount your local content directory to /mnt/host-content (or as configured) and ensure HOST_FILE_PATH aligns with the mounted path.

Tips and common considerations:

• The MCP server can be configured to run in server/client mode, enabling remote deployment and CI/CD workflows.
• If using Docker, the HOST_FILE_PATH environment variable should match the host directory mounted into the container for local image assets.
• For debugging, you can use the official Inspector (npx @modelcontextprotocol/inspector <command>) to test MCP endpoints.
• The npm package name for this server is @wenyan-md/mcp; you can refer to it in your automation scripts or Claude Desktop configurations.
• When running in cloud or remote modes, ensure your WeChat IP whitelisting rules allow requests from the Wenyan MCP server.