Content Publisher

MCP-сервер для публикации контента и сбора метрик на социальных платформах. Реализует протокол MCP (Model Context Protocol).

Платформы

Платформа	Публикация	Метрики	Статус
Telegram	✅ Bot API (sendMessage / sendPhoto)	🚧 Заглушка (V2: Telethon)	Работает, протестировано
YouTube	🚧 Заглушка	🚧 Заглушка	План
Instagram	🚧 Заглушка	🚧 Заглушка	План

Установка

# Установка через uv
uv sync

# С тестовыми зависимостями
uv sync --group test

Настройка

Скопируйте .env.example в .env и укажите токен бота:

cp .env.example .env

# TELEGRAM
TELEGRAM_BOT_TOKEN="токен_от_BotFather"

Токен создаётся через @BotFather в Telegram.

Запуск

# stdio (для интеграции с MCP-хостами — Claude Desktop, Cline и др.)
uv run mcp-content-publisher

# SSE (для отладки и удалённого доступа)
uv run mcp-content-publisher --transport sse --host 127.0.0.1 --port 8001

Инструменты MCP

publish_post

Опубликовать пост на указанной платформе.

Параметры:

• platform (str): telegram | youtube | instagram
• text (str): Текст поста. Поддерживает HTML-разметку (<b>, <i>, <code>, <a href="...">)
• channel (str): Канал для публикации — @username, chat ID или invite link
• media_urls (list[str], optional): URL изображений/видео
• schedule_at (str, optional): Время публикации в ISO-8601

Пример:

{
  "platform": "telegram",
  "text": "<b>Привет!</b> Это тестовый пост из MCP сервера",
  "channel": "-1001234567890"
}

Ответ:

{
  "post_id": "42",
  "status": "published",
  "url": "https://t.me/channel/42",
  "error": null
}

get_metrics

Получить метрики опубликованного поста.

Параметры:

• platform (str): Платформа
• post_id (str): ID поста на платформе

Ответ:

{
  "post_id": "42",
  "platform": "telegram",
  "views": 150,
  "reactions": 12,
  "reposts": 3,
  "comments": 2
}

Примечание: Telegram Bot API не отдаёт реальные просмотры/реакции. В MVP возвращаются mock-данные. В V2 планируется Telethon (MTProto) для реальных метрик.

get_channel_stats

Получить общую статистику канала.

Параметры:

• platform (str): Платформа
• channel (str): Имя/ID канала

Ответ:

{
  "platform": "telegram",
  "channel": "@channel",
  "subscribers": 1000,
  "posts_this_week": 5,
  "avg_views": 200
}

Форматирование текста

Telegram провайдер автоматически определяет режим разметки:

• HTML — если в тексте есть HTML-теги (<b>, <i>, <code>, <a>)
• HTML (по умолчанию) — для обычного текста (не требует экранирования)

Поддерживаемые HTML-теги в Telegram: <b>, <i>, <u>, <s>, <code>, <pre>, <a href="...">

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

# Запуск всех тестов
uv run pytest tests/ -v

# Только unit-тесты
uv run pytest tests/test_publish_server.py -v

# Только интеграционные тесты (MCP протокол)
uv run pytest tests/test_mcp_server_integration.py -v

Что тестируется

• Модели — Pydantic-схемы (PublishContent, PublishResult, PostMetrics, ChannelStats)
• Провайдеры — Telegram (токен, публикация, метрики), YouTube/Instagram (mock)
• Реестр провайдеров — синглтон, неизвестные платформы
• MCP сервер — регистрация инструментов, вызов через MCP протокол

Структура проекта

mcp-content-publisher/
├── src/mcp_content_publisher/
│   ├── server.py          # MCP сервер (точка входа)
│   ├── models.py          # Pydantic-схемы
│   └── providers/
│       ├── base.py        # Базовый класс PublishProvider
│       ├── telegram.py    # Telegram Bot API
│       ├── youtube.py     # YouTube (заглушка)
│       └── instagram.py   # Instagram (заглушка)
├── tests/
│   ├── test_server.py              # Тесты MCP сервера
│   ├── test_publish_server.py      # Тесты провайдеров и моделей
│   └── test_mcp_server_integration.py  # Интеграционные тесты
├── .env.example
└── pyproject.toml

Разработка

# Установка с dev-зависимостями
uv sync --group test

# Запуск тестов
uv run pytest

# Проверка типов
uv run mypy src/