md2wechat

md2wechat is a MCP server written in Go that converts Markdown into WeChat public account HTML. It supports multiple themes (default, bytedance, chinese, apple) and provides word count and estimated reading time. Authentication is supported via an API key. You can invoke the convert_markdown tool through the MCP interface to transform Markdown into WeChat-ready HTML, and you can configure it to work with large language models (e.g., Claude, GPT) for seamless integration into prompts or workflows.

To use it in a workflow, set up the server (via Docker as shown in the install section) and call the convert_markdown tool with your Markdown content. Specify an optional theme to control the output style, and rely on the API key to authorize requests. The server will return a JSON payload containing success status, the generated HTML, the selected theme, word count, and an estimated read time.

Prerequisites:

• Docker installed on your machine (for the recommended Docker-based run)
• Optional: Go 1.21+ if you prefer building locally and running the binary
• API Key for 微信 Markdown 编辑器 (MD2WECHAT) and access to its API

Install steps (Docker-based):

1. Clone or pull the image from your registry if you’re using a prebuilt image, or build the image from source if you maintain your own: docker pull md2wechat-mcp-server

2. Run the MCP server in a container (example): docker run -d --name md2wechat-mcp-server -e MD2WECHAT_API_KEY="wme_your_api_key_here" -p 8080:8080 md2wechat-mcp-server

3. Verify the server is up by curling the health endpoint (adjust to your actual API if different): curl http://localhost:8080/health

4. If you prefer to run locally (Go build): git clone https://github.com/geekjourneyx/md2wechat-mcp-server cd md2wechat-mcp-server go mod tidy export MD2WECHAT_API_KEY="wme_your_api_key_here" go build -o md2wechat-mcp-server ./md2wechat-mcp-server

Prerequisites (local Go build):

• Go 1.21 or higher
• Git
• Access to the MD2WECHAT API Key for environment configuration

Tips and notes:

• Ensure MD2WECHAT_API_KEY is set in your environment for the server to authorize requests.
• The API limits are documented in the README (e.g., 100 KB per request, 100 requests per minute). Monitor usage to avoid throttling.
• Supported themes: default, bytedance, chinese, apple. If an invalid theme is provided, the server should fall back to the default theme.
• When integrating with a Large Language Model, you can embed calls to convert_markdown within prompts or prompts templates to obtain HTML output directly from Markdown input.
• The MCP tool convert_markdown returns a JSON object with fields like success, html, theme, wordCount, and estimatedReadTime; handle errors via the message field or error codes.
• If you run in Docker, remember to map and expose the correct port if you’re calling the server from outside the host.