Telegram MCP Server with Pexels API

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

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

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

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

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

send_message - Отправка текстовых сообщений
send_photo - Отправка фотографий
send_video - Отправка видео
send_document - Отправка документов
send_poll - Создание опросов
send_reaction - Отправка реакций
edit_message - Редактирование сообщений
delete_message - Удаление сообщений
pin_message - Закрепление сообщений
unpin_message - Открепление сообщений
get_channel_info - Получение информации о канале
get_channel_stats - Получение статистики канала

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

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

🛠 Установка

npm install npm run build

🚀 Запуск

# Локальный запуск npm start # Разработка npm run dev

🌐 Деплой на Railway

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

📡 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.1.0
Статус: ✅ Работает
MCP совместимость: ✅ Полная
Telegram интеграция: ✅ Активна
Pexels API: ✅ Активна
Всего инструментов: 17 (12 Telegram + 5 Pexels)

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

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

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

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

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

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

Deploy Server

HTTP connection URL

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Enables interaction with Telegram channels through the Bot API, supporting comprehensive messaging operations including sending text/photos, creating polls, managing reactions, and editing/deleting messages. Provides complete channel management capabilities for automated Telegram bot operations.

Telegram MCP Server