Skip to main content
Glama
GeiserX

telegram-archive-mcp

by GeiserX

Что вы получаете

Тип

Для чего

MCP URI / ID инструмента

Ресурсы

Просмотр статистики архива, чатов и папок (только чтение)

telegram-archive://statstelegram-archive://chatstelegram-archive://folderstelegram-archive://health

Инструменты

Поиск и получение сообщений, проверка статистики чата

search_messagesget_messagesget_pinned_messagesget_messages_by_dateget_chat_statsget_topicsrefresh_stats

Все предоставляется через единую конечную точку JSON-RPC (/mcp). LLM / Агенты могут: initialize -> readResource -> listTools -> callTool ... и так далее.


Related MCP server: telegram-mcp

Быстрый старт (Docker Compose)

services:
  telegram-archive-mcp:
    image: drumsergio/telegram-archive-mcp:latest
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - TELEGRAM_ARCHIVE_URL=http://telegram-archive:3000
      - TELEGRAM_ARCHIVE_USER=your-username
      - TELEGRAM_ARCHIVE_PASS=your-password

Примечание по безопасности: Транспорт HTTP по умолчанию прослушивает 127.0.0.1:8080. Если вам нужно открыть его в сети, разместите его за обратным прокси-сервером с аутентификацией.

Установка через npm (транспорт stdio)

npx telegram-archive-mcp

Или установите глобально:

npm install -g telegram-archive-mcp
telegram-archive-mcp

Это загрузит предварительно собранный бинарный файл Go из GitHub Releases для вашей платформы и запустит его с транспортом stdio. Требуется как минимум один опубликованный релиз.

Локальная сборка

git clone https://github.com/GeiserX/telegram-archive-mcp
cd telegram-archive-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

Конфигурация

Переменная

По умолчанию

Описание

TELEGRAM_ARCHIVE_URL

http://localhost:3000

URL экземпляра Telegram-Archive (без завершающего /)

TELEGRAM_ARCHIVE_USER

(пусто)

Имя пользователя для сессионной аутентификации через /api/login

TELEGRAM_ARCHIVE_PASS

(пусто)

Пароль для сессионной аутентификации через /api/login

LISTEN_ADDR

127.0.0.1:8080

Адрес прослушивания HTTP (Docker устанавливает 0.0.0.0:8080)

TRANSPORT

(пусто = HTTP)

Установите stdio для транспорта stdio

Поместите их в файл .env (из .env.example) или установите их в окружении.

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

Протестировано с помощью Inspector, в настоящее время работает полностью. Перед созданием PR убедитесь, что этот MCP-сервер ведет себя корректно через этот инструмент.

Пример конфигурации для клиентских LLM

{
  "schema_version": "v1",
  "name_for_human": "Telegram-Archive-MCP",
  "name_for_model": "telegram_archive_mcp",
  "description_for_human": "Search messages, browse chats, and access archived Telegram history.",
  "description_for_model": "Interact with a Telegram-Archive instance that stores archived Telegram messages. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with telegram-archive://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "none" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/telegram-archive-mcp/blob/main/LICENSE"
}

Авторы

Telegram-Archive -- архивация и поиск сообщений Telegram

MCP-GO -- современная реализация MCP

GoReleaser -- удобные мультиархитектурные релизы

Сопровождающие

@GeiserX.

Участие в разработке

Присоединяйтесь! Откройте issue или отправьте PR.

Telegram-Archive-MCP следует Кодексу поведения Contributor Covenant.

Другие MCP-серверы от GeiserX

  • cashpilot-mcp — Мониторинг пассивного дохода

  • duplicacy-mcp — Мониторинг состояния резервных копий

  • genieacs-mcp — Управление устройствами TR-069

  • lynxprompt-mcp — Чертежи конфигурации ИИ

  • pumperly-mcp — Цены на топливо и зарядку электромобилей

Связанные проекты

Проект

Описание

Telegram-Archive

Автоматизированное инкрементальное резервное копирование Telegram с локальным веб-просмотрщиком

telegram-delay-channel-cloner

Telegram-бот, который пересылает сообщения между каналами с настраиваемой задержкой

telegram-slskd-local-bot

Автоматизированный поиск и загрузка музыки через Telegram-бота с Soulseek

paperless-telegram-bot

Управление документами Paperless-NGX полностью через Telegram

n8n-nodes-telegram-archive

Узел сообщества n8n для Telegram-Archive

A
license - permissive license
B
quality
A
maintenance

Maintenance

Maintainers
Response time
1wRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that connects AI assistants to your real Telegram account via User API (MTProto). Features default-deny ACL with per-chat permissions, message search, file sending, forwarding, media downloads, and rate limiting.
    2
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that connects to a Telegram group chat, persists messages to a local SQLite database, and exposes tools to search, retrieve, and send messages via SSE.
  • A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that connects to Telegram as your real user account and exposes read-only tools to read and search messages, list chats and folders, inspect group info, and download media.
    9
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    A local MCP server that enables full-text and semantic search over your own Telegram chats using your personal MTProto login, with everything running locally.
    7
    MIT

View all related MCP servers

Related MCP Connectors

  • Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeiserX/telegram-archive-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server