Skip to main content
Glama
GeiserX

telegram-archive-mcp

by GeiserX

Qué obtienes

Tipo

Para qué sirve

URI de MCP / ID de herramienta

Recursos

Navegar por estadísticas de archivo, chats y carpetas (solo lectura)

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

Herramientas

Buscar y recuperar mensajes, inspeccionar estadísticas de chat

search_messagesget_messagesget_pinned_messagesget_messages_by_dateget_chat_statsget_topicsrefresh_stats

Todo se expone a través de un único endpoint JSON-RPC (/mcp). Los LLMs / Agentes pueden: initialize -> readResource -> listTools -> callTool ... y así sucesivamente.


Related MCP server: telegram-mcp

Inicio rápido (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

Nota de seguridad: El transporte HTTP escucha en 127.0.0.1:8080 por defecto. Si necesitas exponerlo en una red, colócalo detrás de un proxy inverso con autenticación.

Instalación vía npm (transporte stdio)

npx telegram-archive-mcp

O instálalo globalmente:

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

Esto descarga el binario de Go precompilado desde GitHub Releases para tu plataforma y lo ejecuta con transporte stdio. Requiere al menos una versión publicada.

Compilación local

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

Configuración

Variable

Por defecto

Descripción

TELEGRAM_ARCHIVE_URL

http://localhost:3000

URL de la instancia de Telegram-Archive (sin barra final)

TELEGRAM_ARCHIVE_USER

(vacío)

Nombre de usuario para autenticación de sesión vía /api/login

TELEGRAM_ARCHIVE_PASS

(vacío)

Contraseña para autenticación de sesión vía /api/login

LISTEN_ADDR

127.0.0.1:8080

Dirección de escucha HTTP (Docker establece 0.0.0.0:8080)

TRANSPORT

(vacío = HTTP)

Establecer en stdio para transporte stdio

Ponlos en un archivo .env (desde .env.example) o establécelos en el entorno.

Pruebas

Probado con Inspector y actualmente funciona perfectamente. Antes de realizar un PR, asegúrate de que este servidor MCP se comporte correctamente a través de este medio.

Ejemplo de configuración para LLMs cliente

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

Créditos

Telegram-Archive -- Archivado y búsqueda de mensajes de Telegram

MCP-GO -- Implementación moderna de MCP

GoReleaser -- Lanzamientos multi-arquitectura sin complicaciones

Mantenedores

@GeiserX.

Contribución

¡Siéntete libre de participar! Abre un issue o envía PRs.

Telegram-Archive-MCP sigue el Código de Conducta del Contributor Covenant.

Otros servidores MCP de GeiserX

Proyectos relacionados

Proyecto

Descripción

Telegram-Archive

Copias de seguridad de Telegram automatizadas e incrementales con visor web local

telegram-delay-channel-cloner

Bot de Telegram que retransmite mensajes entre canales con retardo configurable

telegram-slskd-local-bot

Descubrimiento y descarga automática de música vía bot de Telegram con Soulseek

paperless-telegram-bot

Gestiona documentos de Paperless-NGX completamente a través de Telegram

n8n-nodes-telegram-archive

Nodo de la comunidad n8n para 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