telegram-mcp-server

bobidk91-ops/telegram-mcp-server

3.1

If you are the rightful owner of telegram-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This document provides a structured summary of a Model Context Protocol (MCP) server designed for integration with Telegram.

Telegram MCP Server with Pexels & WordPress

Полнофункциональный MCP (Model Context Protocol) сервер для интеграции с Telegram каналами, Pexels API и WordPress.

🚀 Возможности

  • 12 Telegram функций: отправка сообщений, фото, видео, документов, опросов, реакций, редактирование, удаление, закрепление сообщений
  • 5 Pexels API функций: поиск фото и видео, кураторские подборки, популярные видео
  • 40+ WordPress функций: полное управление постами, страницами, медиа, пользователями, категориями, тегами, комментариями
  • MCP протокол: полная поддержка JSON-RPC 2.0
  • HTTP API: поддержка как MCP, так и REST API
  • Railway деплой: готов к развертыванию в облаке
  • UTF-8 поддержка: корректная обработка русского текста

📋 Доступные инструменты

Telegram (12 инструментов)

  1. send_message - Отправка текстовых сообщений
  2. send_photo - Отправка фотографий
  3. send_video - Отправка видео
  4. send_document - Отправка документов
  5. send_poll - Создание опросов
  6. send_reaction - Отправка реакций
  7. edit_message - Редактирование сообщений
  8. delete_message - Удаление сообщений
  9. pin_message - Закрепление сообщений
  10. unpin_message - Открепление сообщений
  11. get_channel_info - Получение информации о канале
  12. get_channel_stats - Получение статистики канала

Pexels API (5 инструментов)

  1. pexels_search_photos - Поиск фотографий по запросу
  2. pexels_get_photo - Получение фото по ID
  3. pexels_curated_photos - Кураторские фотографии
  4. pexels_search_videos - Поиск видео по запросу
  5. pexels_popular_videos - Популярные видео

WordPress (40+ инструментов)

Посты (Posts)
  1. wordpress_get_posts - Получение списка постов
  2. wordpress_get_post - Получение поста по ID
  3. wordpress_create_post - Создание нового поста
  4. wordpress_update_post - Обновление поста
  5. wordpress_delete_post - Удаление поста
Страницы (Pages)
  1. wordpress_get_pages - Получение списка страниц
  2. wordpress_get_page - Получение страницы по ID
  3. wordpress_create_page - Создание новой страницы
  4. wordpress_update_page - Обновление страницы
  5. wordpress_delete_page - Удаление страницы
Медиафайлы (Media)
  1. wordpress_get_media - Получение списка медиафайлов
  2. wordpress_get_media_item - Получение медиафайла по ID
  3. wordpress_upload_media - Загрузка медиафайла
  4. wordpress_update_media - Обновление медиафайла
  5. wordpress_delete_media - Удаление медиафайла
Категории (Categories)
  1. wordpress_get_categories - Получение списка категорий
  2. wordpress_get_category - Получение категории по ID
  3. wordpress_create_category - Создание новой категории
  4. wordpress_update_category - Обновление категории
  5. wordpress_delete_category - Удаление категории
Теги (Tags)
  1. wordpress_get_tags - Получение списка тегов
  2. wordpress_get_tag - Получение тега по ID
  3. wordpress_create_tag - Создание нового тега
  4. wordpress_update_tag - Обновление тега
  5. wordpress_delete_tag - Удаление тега
Пользователи (Users)
  1. wordpress_get_users - Получение списка пользователей
  2. wordpress_get_user - Получение пользователя по ID
  3. wordpress_create_user - Создание нового пользователя
  4. wordpress_update_user - Обновление пользователя
  5. wordpress_delete_user - Удаление пользователя
Комментарии (Comments)
  1. wordpress_get_comments - Получение списка комментариев
  2. wordpress_get_comment - Получение комментария по ID
  3. wordpress_create_comment - Создание нового комментария
  4. wordpress_update_comment - Обновление комментария
  5. wordpress_delete_comment - Удаление комментария
Информация о сайте
  1. wordpress_get_site_info - Получение информации о сайте
  2. wordpress_get_settings - Получение настроек сайта
  3. wordpress_search - Поиск по контенту
  4. wordpress_test_connection - Проверка соединения

🛠 Установка

npm install
npm run build

🚀 Запуск

# Локальный запуск
npm start

# Разработка
npm run dev

🌐 Деплой на Railway

  1. Подключите GitHub репозиторий к Railway
  2. Railway автоматически определит Node.js проект
  3. Настройте переменные окружения:
    • TELEGRAM_BOT_TOKEN - токен Telegram бота
    • TELEGRAM_CHANNEL_ID - ID канала (например, @channel)
    • PEXELS_API_KEY - API ключ Pexels (получить на https://www.pexels.com/api/)
    • WORDPRESS_URL - URL вашего WordPress сайта
    • WORDPRESS_USERNAME - имя пользователя WordPress
    • WORDPRESS_APPLICATION_PASSWORD - пароль приложения WordPress

📡 API Endpoints

  • GET / - Информация о сервере
  • GET /health - Проверка здоровья
  • GET /tools/list - Список инструментов (MCP)
  • POST / - MCP JSON-RPC 2.0 эндпоинт

🔧 Использование

MCP клиенты (ChatGPT, Claude Desktop)

URL: https://telegram-mcp-server-production.up.railway.app

REST API

# Получить список инструментов
curl https://telegram-mcp-server-production.up.railway.app/tools/list

# Отправить сообщение
curl -X POST https://telegram-mcp-server-production.up.railway.app \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "send_message",
      "arguments": {
        "text": "Привет из MCP сервера!",
        "parse_mode": "HTML"
      }
    },
    "id": 1
  }'

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

├── src/
│   ├── simple-server.ts    # Основной MCP сервер
│   └── index.ts           # Альтернативная реализация
├── dist/                  # Скомпилированный код
├── package.json           # Зависимости и скрипты
├── Procfile              # Конфигурация Railway
├── tsconfig.json         # TypeScript конфигурация
└── README.md            # Документация

✅ Статус

  • Railway URL: https://telegram-mcp-server-production.up.railway.app
  • Версия: v2.2.0
  • Статус: ✅ Работает
  • MCP совместимость: ✅ Полная
  • Telegram интеграция: ✅ Активна
  • Pexels API: ✅ Активна
  • WordPress интеграция: ✅ Активна
  • Всего инструментов: 56+ (12 Telegram + 5 Pexels + 40+ WordPress)

📖 Документация

  • - Полная документация по WordPress интеграции
  • - Полная документация по Pexels интеграции
  • - Настройка Telegram бота
  • - Решение проблем

🎯 Готов к использованию!

Сервер полностью настроен и готов к работе с ChatGPT, Claude Desktop и другими MCP клиентами.

Новые возможности v2.2.0:

  • 🌐 Полная интеграция с WordPress REST API
  • 📝 Управление постами, страницами, медиафайлами
  • 👥 Управление пользователями, категориями, тегами
  • 💬 Управление комментариями
  • 🔍 Поиск по контенту WordPress
  • 📤 Загрузка медиафайлов по URL
  • 🔐 Аутентификация через Application Passwords

Возможности v2.1.0:

  • ✨ Интеграция с Pexels API
  • 🖼️ Поиск высококачественных фотографий
  • 🎥 Поиск профессиональных видео
  • 📸 Кураторские подборки
  • 🔥 Популярные видео