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 Releasesからプラットフォーム用のビルド済みGoバイナリがダウンロードされ、stdioトランスポートで実行されます。少なくとも1つの公開リリースが必要です。

ローカルビルド

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 でテスト済みであり、現在完全に動作しています。プルリクエストを作成する前に、この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を開くか、プルリクエストを送信してください。

Telegram-Archive-MCPは Contributor Covenant 行動規範に従っています。

GeiserXによるその他のMCPサーバー

関連プロジェクト

プロジェクト

説明

Telegram-Archive

ローカルWebビューアを備えた自動増分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