微信 Markdown 转换 MCP

把 Markdown 转成适合微信公众号的内联样式 HTML。服务只负责渲染输出，复制富文本交给用户现有工作流（浏览器、Doocs/md、WeMD、mdnice 等）。

工具

转换成功后自动缓存 HTML 到 ./.cache/wechat-mcp/，可通过 WECHAT_MCP_CACHE_DIR 环境变量覆盖。

Related MCP server: Xiayan MCP Server

运行

uvx --from "git+https://github.com/huxuanming/wechat-md-mcp-server.git" wechat-md-mcp-server

本地开发：

uvx --from . wechat-md-mcp-server

查看可用工具：

uvx --from . wechat-md-mcp-server --list-tools

MCP 配置示例

远程（GitHub）：

{
  "mcpServers": {
    "wechat-md-mcp-server": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/huxuanming/wechat-md-mcp-server.git", "wechat-md-mcp-server"]
    }
  }
}

本地开发（推荐用 uv run，自动感知代码变化）：

{
  "mcpServers": {
    "wechat-md-mcp-server": {
      "command": "uv",
      "args": ["--directory", "/path/to/wechat-md-mcp-server", "run", "wechat-md-mcp-server"]
    }
  }
}

本地开发不要用 uvx --from /path，uvx 会缓存构建产物，代码修改后不会自动重建。

工具参数

convert_markdown_to_wechat_html

输出：HTML 字符串（<article>...</article>）。

list_wechat_themes

无参数，返回主题名称和描述列表。

主题

命令行工具

wechat-md-convert 可直接转换本地 Markdown 文件：

uvx --from . wechat-md-convert input.md --theme tech --out output.html

支持的 Markdown 语法

• 标题：# 到 ######

• 段落、换行

• 无序列表（- / * / +）、有序列表

• 引用：>

• 分割线：--- 或 ***

• 粗体：**bold**，斜体：*italic*，嵌套：**bold *italic* bold**

• 行内代码：`code`

• 代码块：```lang ... ```

• 链接：[text](https://...) / [text](#anchor) / [text](mailto:...)

快速验证

uvx --from . python3 - <<'PY'
import server as s
md = "# 标题\n\n这是**测试**，带[链接](https://example.com)和`代码`。"
print(s.parse_markdown(md, theme_name="default")[:300])
PY

缓存目录优先级

1. WECHAT_MCP_CACHE_DIR 环境变量

2. <输入文件目录>/.cache/wechat-mcp/

3. ~/.cache/wechat-mcp/（macOS：~/Library/Caches/wechat-mcp/）

4. 系统临时目录