Telegram Archive Mcp

Name: Telegram Archive Mcp
Author: GeiserX

@GeiserX

リポジトリ

Telegram Archive Mcp について

概要はまだありません

基本情報

カテゴリ

コミュニケーション

トランスポート

stdio

公開者

GeiserX

投稿者

Sergio Fernández

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "http://localhost:3000",
        "TELEGRAM_ARCHIVE_USER": "",
        "TELEGRAM_ARCHIVE_PASS": ""
      }
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Telegram Archive Mcp?

Telegram Archive Mcp is a bridge that exposes any Telegram-Archive instance as an MCP server, enabling LLMs to search messages, browse chats, and access archived Telegram history. It is designed for developers and AI agents who need programmatic access to archived Telegram data.

How to use Telegram Archive Mcp?

Deploy via Docker Compose or install with npx telegram-archive-mcp (or global npm install). Configure the Telegram-Archive instance URL and optional credentials via environment variables (TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_USER, TELEGRAM_ARCHIVE_PASS). The server runs an HTTP JSON-RPC endpoint on port 8080 (or stdio transport). Clients call initialize, then use readResource and callTool to interact.

Key features of Telegram Archive Mcp

Exposes archive stats, chats, and folders as read-only resources
Provides search, retrieve, and statistics tools for messages
Single JSON-RPC endpoint at /mcp
Supports both HTTP and stdio transports
Easy configuration via environment variables
Available as Docker image and npm package

Use cases of Telegram Archive Mcp

Search archived Telegram messages using natural language from an LLM
Browse chat statistics and folder structures programmatically
Retrieve pinned messages or messages filtered by date
Integrate telegram archive search into AI agent workflows

FAQ from Telegram Archive Mcp

What does Telegram Archive Mcp need to run?

It requires a running Telegram-Archive instance and optionally its login credentials. The server itself can be run via Docker or Go binary (Go 1.24+).

How do I configure authentication?

Set TELEGRAM_ARCHIVE_USER and TELEGRAM_ARCHIVE_PASS environment variables for session-based authentication with the Telegram-Archive instance. Authentication is optional if the archive does not require it.

What transport options are available?

The default transport is HTTP (listening on 127.0.0.1:8080). Set the TRANSPORT environment variable to stdio to use stdio transport instead.

What resources and tools does it provide?

Resources: telegram-archive://stats, telegram-archive://chats, telegram-archive://folders, telegram-archive://health. Tools: search_messages, get_messages, get_pinned_messages, get_messages_by_date, get_chat_stats, get_topics, refresh_stats.