返回市场
md2wechat-MCP服务器

md2wechat-MCP服务器

作者:geekjourneyx39 星标更新:2025-06-25

项目介绍

微信 Markdown 编辑器 MCP 服务器

基于 MCP (Model Context Protocol) 的 Go 服务器,用于将 Markdown 文本转换为微信官方账号格式的 HTML。

功能

  • 🚀 快速转换:将 Markdown 文本转换为与微信官方账号兼容的 HTML 格式
  • 🎨 多种主题:支持 4 种主题风格(默认、字节风格、中式风格、苹果风格)
  • 📊 详细统计:提供字数统计和预估阅读时间
  • 🔒 安全认证:支持 API Key 认证
  • 💬 智能集成:无缝集成大型语言模型如 Claude 和 GPT

支持的 Markdown 语法

基础语法

  • 标题(H1-H6)
  • 段落和换行
  • 粗体文本斜体文本
  • 内联代码
  • 链接
  • ![图片](https://example.com/image.jpg)
  • 无序列表和有序列表
  • 引用块

  • 分割线(---)

扩展语法

  • 代码块(支持语法高亮)
  • 表格
  • 脚注 [^ 1]
  • GFM 提示框(NOTE, TIP, IMPORTANT, Warning, CAUTION)

环境需求

  • Go 1.21 或更高版本
  • 微信 Markdown 编辑器 API Key

安装和配置

1. 克隆或下载代码

git clone https://github.com/geekjourneyx/md2wechat-mcp-server
cd md2wechat-mcp-server

2. 安装依赖

go mod tidy

3. 设置 API Key

获取微信 Markdown 编辑器的 API Key 后,设置环境变量:

# Linux/macOS
export MD2WECHAT_API_KEY="wme_your_api_key_here"

# Windows
set MD2WECHAT_API_KEY=wme_your_api_key_here

4. 构建和运行

# 构建
go build -o md2wechat-mcp-server

# 运行
./md2wechat-mcp-server

MCP 工具说明

convert_markdown

将 Markdown 文本转换为微信官方账号格式的 HTML。

参数

参数名称类型必填描述
markdownstring需要转换的 Markdown 文本内容
themestring主题风格,默认为 "default"

支持的主题:

  • default - 默认微信经典风格
  • bytedance - 字节风格(科技现代风格)
  • chinese - 中式风格(古典优雅风格)
  • apple - 苹果风格(视觉渐变风格)

返回结果:

{
  "success": true,
  "html": "<section>...</section>",
  "theme": "default",
  "wordCount": 156,
  "estimatedReadTime": 1,
  "message": "Markdown 转换成功"
}

在大型语言模型中的使用

Claude Desktop 配置

claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "md2wechat": {
      "command": "/path/to/md2wechat-mcp-server",
      "env": {
        "MD2WECHAT_API_KEY": "wme_your_api_key_here"
      }
    }
  }
}

使用示例

与 Claude 对话时,可以请求如下内容:

请帮我将以下 Markdown 文本转换为微信公众号格式:

# 我的文章标题

这是一个**重要**的段落。

## 子标题

- 列表项 1
- 列表项 2

使用中国风主题。

Claude 将调用 convert_markdown 工具并返回转换后的 HTML 代码。

错误处理

服务器将处理以下常见错误:

  • API Key 未设置或无效
  • Markdown 内容为空
  • 主题参数无效
  • 网络连接问题
  • API 服务异常

API 限制

  • 单个请求的 Markdown 内容不应超过 100KB
  • API Key 额度:每分钟 100 次请求
  • 网络请求超时:30 秒

开发和贡献

项目结构

md2wechat-mcp-server/
├── main.go          # 主程序文件
├── go.mod           # Go 模块依赖
├── README.md        # 说明文档
└── api_doc.md       # 原始 API 文档

开发建议

  1. 遵循 Go 代码规范
  2. 添加适当的错误处理
  3. 编写详细的注释
  4. 测试 API 集成

许可证

该项目在 MIT 许可证下开源。

支持和反馈

如有任何疑问或建议,请提交问题或联系开发团队。


注意在使用前,请确保已正确配置 API Key 并遵守微信 Markdown 编辑器的使用条款。