Skip to main content
Glama
GeiserX

telegram-archive-mcp

by GeiserX

Was Sie erhalten

Typ

Verwendungszweck

MCP-URI / Tool-ID

Ressourcen

Archivstatistiken, Chats und Ordner schreibgeschützt durchsuchen

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

Tools

Nachrichten suchen und abrufen, Chat-Statistiken einsehen

search_messagesget_messagesget_pinned_messagesget_messages_by_dateget_chat_statsget_topicsrefresh_stats

Alles wird über einen einzigen JSON-RPC-Endpunkt (/mcp) bereitgestellt. LLMs / Agenten können: initialize -> readResource -> listTools -> callTool ... und so weiter.


Related MCP server: telegram-mcp

Schnellstart (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

Sicherheitshinweis: Der HTTP-Transport lauscht standardmäßig auf 127.0.0.1:8080. Wenn Sie ihn in einem Netzwerk freigeben müssen, platzieren Sie ihn hinter einem Reverse-Proxy mit Authentifizierung.

Installation via npm (stdio-Transport)

npx telegram-archive-mcp

Oder global installieren:

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

Dies lädt das vorkompilierte Go-Binary von GitHub Releases für Ihre Plattform herunter und führt es mit stdio-Transport aus. Erfordert mindestens ein veröffentlichtes Release.

Lokaler Build

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

Konfiguration

Variable

Standardwert

Beschreibung

TELEGRAM_ARCHIVE_URL

http://localhost:3000

URL der Telegram-Archive-Instanz (ohne abschließenden /)

TELEGRAM_ARCHIVE_USER

(leer)

Benutzername für die Sitzungsauthentifizierung via /api/login

TELEGRAM_ARCHIVE_PASS

(leer)

Passwort für die Sitzungsauthentifizierung via /api/login

LISTEN_ADDR

127.0.0.1:8080

HTTP-Lauschadresse (Docker setzt 0.0.0.0:8080)

TRANSPORT

(leer = HTTP)

Auf stdio für stdio-Transport setzen

Tragen Sie diese in eine .env-Datei ein (aus .env.example) oder setzen Sie sie in der Umgebung.

Testen

Getestet mit dem Inspector und es funktioniert derzeit einwandfrei. Bevor Sie einen PR erstellen, stellen Sie sicher, dass sich dieser MCP-Server über dieses Medium korrekt verhält.

Beispielkonfiguration für Client-LLMs

{
  "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"
}

Credits

Telegram-Archive -- Telegram-Nachrichtenarchivierung und -suche

MCP-GO -- moderne MCP-Implementierung

GoReleaser -- einfache Multi-Arch-Releases

Betreuer

@GeiserX.

Mitwirken

Fühlen Sie sich eingeladen, mitzumachen! Eröffnen Sie ein Issue oder senden Sie PRs.

Telegram-Archive-MCP folgt dem Contributor Covenant Verhaltenskodex.

Andere MCP-Server von GeiserX

Verwandte Projekte

Projekt

Beschreibung

Telegram-Archive

Automatisierte, inkrementelle Telegram-Backups mit lokalem Web-Viewer

telegram-delay-channel-cloner

Telegram-Bot, der Nachrichten mit konfigurierbarer Verzögerung zwischen Kanälen weiterleitet

telegram-slskd-local-bot

Automatisierte Musikentdeckung und -download via Telegram-Bot mit Soulseek

paperless-telegram-bot

Paperless-NGX-Dokumente vollständig über Telegram verwalten

n8n-nodes-telegram-archive

n8n-Community-Node für 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