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

이 명령은 GitHub 릴리스에서 플랫폼에 맞는 사전 빌드된 Go 바이너리를 다운로드하고 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

Telegram-Archive 인스턴스 URL (끝에 / 제외)

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.

기여

언제든 참여해 주세요! 이슈를 열거나 PR을 제출해 주십시오.

Telegram-Archive-MCP는 Contributor Covenant 행동 강령을 따릅니다.

GeiserX의 다른 MCP 서버

관련 프로젝트

프로젝트

설명

Telegram-Archive

로컬 웹 뷰어가 포함된 자동 증분 Telegram 백업

telegram-delay-channel-cloner

구성 가능한 지연 시간으로 채널 간 메시지를 중계하는 Telegram 봇

telegram-slskd-local-bot

Soulseek을 사용하여 Telegram 봇을 통한 자동 음악 검색 및 다운로드

paperless-telegram-bot

Telegram을 통해 Paperless-NGX 문서 전체 관리

n8n-nodes-telegram-archive

Telegram-Archive용 n8n 커뮤니티 노드

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