Markdown to WeChat Converter

Servidor MCP do Editor Markdown para WeChat

Este é um servidor Go baseado em MCP (Model Context Protocol) para converter texto Markdown em HTML no formato da conta oficial do WeChat.

Recursos

• 🚀 Conversão rápida: Converte texto Markdown em HTML compatível com a conta oficial do WeChat
• 🎨 Múltiplos temas: Suporta 4 estilos de tema (padrão, ByteDance, estilo chinês, estilo Apple)
• 📊 Estatísticas detalhadas: Fornece contagem de palavras e tempo estimado de leitura
• 🔒 Autenticação segura: Suporta autenticação por API Key
• 💬 Integração inteligente: Pode ser integrado perfeitamente com modelos de linguagem grandes (como Claude, GPT)

Sintaxe Markdown suportada

Sintaxe básica

• Títulos (H1-H6)
• Parágrafos e quebras de linha
• Texto em negrito e texto em itálico
• 内联代码
• Link
• ![图片](https://example.com/image.jpg)
• Listas não ordenadas e ordenadas

• Bloco de citação

• Linha divisória (---)

Sintaxe estendida

• Blocos de código (com realce de sintaxe)
• Tabelas
• Notas de rodapé [^1]
• Caixas de aviso GFM (NOTE, TIP, IMPORTANT, WARNING, CAUTION)

Requisitos de ambiente

• Go 1.21 ou superior
• API Key do Editor Markdown do WeChat

Instalação e configuração

1. Clone ou baixe o código

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

2. Instale as dependências

go mod tidy

3. Configure a API Key

Após obter a API Key do Editor Markdown do WeChat, defina a variável de ambiente:

# Linux/macOS
export MD2WECHAT_API_KEY="wme_your_api_key_here"

# Windows
set MD2WECHAT_API_KEY=wme_your_api_key_here

4. Compile e execute

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

# 运行
./md2wechat-mcp-server

Descrição das ferramentas MCP

convert_markdown

Converte texto Markdown em HTML no formato da conta oficial do WeChat.

Parâmetros:

Nome do parâmetro	Tipo	Obrigatório	Descrição
markdown	string	✅	Conteúdo do texto Markdown a ser convertido
theme	string	❌	Estilo do tema, padrão "default"

Temas suportados:

• default - Estilo clássico padrão do WeChat
• bytedance - Estilo ByteDance (estilo moderno e tecnológico)
• chinese - Estilo chinês (estilo clássico e elegante)
• apple - Estilo Apple (estilo com gradiente visual)

Resultado retornado:

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

Uso em modelos de linguagem grandes

Configuração do Claude Desktop

Adicione em claude_desktop_config.json:

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

Exemplo de uso

Ao conversar com o Claude, você pode solicitar assim:

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

# 我的文章标题

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

## 子标题

- 列表项 1
- 列表项 2

使用中国风主题。

O Claude chamará a ferramenta convert_markdown e retornará o código HTML convertido.

Tratamento de erros

O servidor tratará os seguintes erros comuns:

• API Key não definida ou inválida
• Conteúdo Markdown vazio
• Parâmetro de tema inválido
• Problemas de conexão de rede
• Erro no serviço da API

Limites da API

• O conteúdo Markdown por solicitação não pode exceder 100KB
• Cota da API Key: 100 solicitações/minuto
• Timeout de solicitação de rede: 30 segundos

Desenvolvimento e contribuição

Estrutura do projeto

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

Sugestões de desenvolvimento

1. Siga as convenções de código Go
2. Adicione tratamento de erros adequado
3. Escreva comentários detalhados
4. Teste a integração da API

Licença

Este projeto é open source sob a licença MIT.

Suporte e feedback

Se tiver problemas ou sugestões, envie um Issue ou entre em contato com a equipe de desenvolvimento.

---

Atenção: Antes de usar, certifique-se de configurar corretamente a API Key e siga os termos de uso do Editor Markdown do WeChat.