wechat-mcp-publisher

Локальный MCP-инструмент для публикации черновиков в официальном аккаунте WeChat. Превращает «готовый HTML → черновик официального аккаунта» в один вызов инструмента LLM: загрузка изображений, замена встроенных изображений в тексте на URL WeChat, материалы обложки и создание черновика — всё выполняется автоматически.

Построен на официальном SDK mcp (2.x MCPServer), транспорт stdio, один аккаунт, зависимости управляются через uv.

Инструменты (5)

access_token получается внутри, кэшируется и самовосстанавливается при истечении (stable_token + автоматическое обновление и повторная попытка при кодах 40001/42001), не предоставляется как инструмент. Ошибки единообразно преобразуются в сообщения на китайском языке с подсказками по устранению (например, 40164 — добавить IP в белый список, 48001 — нужна верифицированная учётная запись) и не содержат учётных данных.

Related MCP server: WeChat Official Account MCP Server

Установка

uv sync
cp .env.example .env   # 填入 WECHAT_APP_ID / WECHAT_APP_SECRET

Получение учётных данных: mp.weixin.qq.com → «Настройки и разработка» → «Основная конфигурация». На той же странице необходимо добавить публичный IP этой машины в IP-белый список, иначе при получении token будет ошибка 40164.

После публикации на PyPI также можно запускать без клонирования (в каталоге с .env):

uvx wechat-mcp-publisher
# 或 pip install wechat-mcp-publisher && wechat-mcp-publisher

В этом случае конфигурация MCP-клиента упрощается до "command": "uvx", "args": ["wechat-mcp-publisher"].

Подключение MCP-клиента

Claude Code (рекомендуется, одна команда):

claude mcp add wechat-mcp-publisher -- uv run --directory /你的路径/wechat-mcp-publisher python -m wechat_mcp_publisher

Конфигурация уровня проекта (в этом репозитории уже есть .mcp.json; Claude Code активирует её при открытии каталога репозитория, при первом запуске нужно подтвердить доверие в /mcp): добавлять вручную не требуется.

Claude Desktop / другие клиенты: вставьте фрагмент из examples/mcp-client-config.example.json в соответствующий конфигурационный файл.

Примеры использования

Скажите LLM:

Помоги мне отправить /path/article.html как черновик статьи официального аккаунта, обложка — /path/cover.jpg

Или сообщение с изображениями:

Отправь эти три изображения /a.jpg /b.jpg /c.jpg как черновик сообщения с картинками, пояснение: кадры выходных

Демонстрация реальной цепочки API — в examples/simple_usage.py (token → загрузка → создание черновика, используется также как smoke-тест на реальном устройстве).

Тестирование

uv run pytest

Все интерфейсы замоканы через responses, для прохождения не нужен реальный аккаунт.

Область применения и известные ограничения

• Не выполняет преобразование markdown→HTML: на входе — HTML; для преобразования используйте уже имеющийся у вас инструмент md→html

• Не выполняет публикацию (freepublish): сейчас работает только до черновика; публикация остаётся на потом, после верификации аккаунта

• Личный неверифицированный подписной аккаунт: API материалов/черновиков возвращает 48001; для проверки на реальном устройстве нужен верифицированный аккаунт (на разработку и тестирование не влияет)

• Совместимость HTML с WeChat: редактор WeChat распознаёт только подмножество HTML с инлайновыми стилями; адаптацию вёрстки выполняет вышестоящий инструмент преобразования; данный инструмент не проверяет и не исправляет

• Накопление материалов: удаление черновика не удаляет занятые им постоянные изображения; при длительном использовании нужно периодически чистить их в панели управления официального аккаунта

• Один аккаунт: учётные данные берутся из .env, переключение между аккаунтами не предусмотрено