English Français العربية

Telegram Archive

السجل الرسمي البحث والويب

Search and read your archived Telegram chats and messages

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Telegram Archive؟

  • Read-only resources for archive stats, chats, folders and health (telegram-archive://stats, telegram-archive://chats).
  • Message search, message paging by offset or keyset cursor, and whole calendar days in a timezone (get_messages_by_date).
  • Pinned messages, forum topics and per-chat statistics.
  • The photo attached to a message, returned as an image the model can look at and scaled to 1568 pixels when larger (get_media).
  • Signs in to Telegram-Archive through /api/login with TELEGRAM_ARCHIVE_USER and TELEGRAM_ARCHIVE_PASS.
  • One JSON-RPC endpoint (/mcp) over HTTP, or stdio with TRANSPORT=stdio.
  • Listens on loopback by default; MCP_AUTH_TOKEN adds bearer auth when you expose it.
  • Ships as a Docker image, an npm package (npx telegram-archive-mcp) and multi-arch Go binaries.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package telegram-archive-mcp
Claude Code 
claude mcp add telegram-archive -e 'TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL>' -e 'TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER>' -e 'TELEGRAM_ARCHIVE_PASS=<your telegram_archive_pass>' -e 'READ_ONLY=<READ_ONLY>' -- npx -y telegram-archive-mcp@0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "telegram-archive": {
            "command": "npx",
            "args": [
                "-y",
                "telegram-archive-mcp@0.4.0"
            ],
            "env": {
                "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
                "TELEGRAM_ARCHIVE_USER": "<TELEGRAM_ARCHIVE_USER>",
                "TELEGRAM_ARCHIVE_PASS": "<your telegram_archive_pass>",
                "READ_ONLY": "<READ_ONLY>"
            }
        }
    }
}

متغيرات البيئة

  • TELEGRAM_ARCHIVE_URL إلزامي Telegram Archive instance URL (e.g. http://localhost:8000)
  • TELEGRAM_ARCHIVE_USER Telegram Archive login username
  • TELEGRAM_ARCHIVE_PASS سري Telegram Archive login password
  • READ_ONLY Set to true to hide refresh_stats, the one tool that asks the viewer to do work
OCI package drumsergio/telegram-archive-mcp:v0.4.0
Claude Code 
claude mcp add telegram-archive -e 'TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL>' -e 'TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER>' -e 'TELEGRAM_ARCHIVE_PASS=<your telegram_archive_pass>' -e 'READ_ONLY=<READ_ONLY>' -- docker run -i --rm drumsergio/telegram-archive-mcp:v0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "telegram-archive": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "drumsergio/telegram-archive-mcp:v0.4.0"
            ],
            "env": {
                "TELEGRAM_ARCHIVE_URL": "<TELEGRAM_ARCHIVE_URL>",
                "TELEGRAM_ARCHIVE_USER": "<TELEGRAM_ARCHIVE_USER>",
                "TELEGRAM_ARCHIVE_PASS": "<your telegram_archive_pass>",
                "READ_ONLY": "<READ_ONLY>"
            }
        }
    }
}

متغيرات البيئة

  • TELEGRAM_ARCHIVE_URL إلزامي Telegram Archive instance URL (e.g. http://localhost:8000)
  • TELEGRAM_ARCHIVE_USER Telegram Archive login username
  • TELEGRAM_ARCHIVE_PASS سري Telegram Archive login password
  • READ_ONLY Set to true to hide refresh_stats, the one tool that asks the viewer to do work

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. telegram-archive-mcp
  2. Features
  3. Quick start
  4. Documentation
  5. License

telegram-archive-mcp

An MCP server for any Telegram-Archive instance. LLMs use it to search messages, browse chats and read archived Telegram history.

Features

  • Read-only resources for archive stats, chats, folders and health (telegram-archive://stats, telegram-archive://chats).
  • Message search, message paging by offset or keyset cursor, and whole calendar days in a timezone (get_messages_by_date).
  • Pinned messages, forum topics and per-chat statistics.
  • The photo attached to a message, returned as an image the model can look at and scaled to 1568 pixels when larger (get_media).
  • Signs in to Telegram-Archive through /api/login with TELEGRAM_ARCHIVE_USER and TELEGRAM_ARCHIVE_PASS.
  • One JSON-RPC endpoint (/mcp) over HTTP, or stdio with TRANSPORT=stdio.
  • Listens on loopback by default; MCP_AUTH_TOKEN adds bearer auth when you expose it.
  • Ships as a Docker image, an npm package (npx telegram-archive-mcp) and multi-arch Go binaries.

Quick start

npx telegram-archive-mcp

npx fetches the server and runs it on stdio, so your MCP client starts it for you. For Claude Desktop, Cursor or Claude Code, add:

{
  "mcpServers": {
    "telegram-archive": {
      "command": "npx",
      "args": ["-y", "telegram-archive-mcp"],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "http://localhost:8000",
        "TELEGRAM_ARCHIVE_USER": "admin",
        "TELEGRAM_ARCHIVE_PASS": "your-viewer-password"
      }
    }
  }
}

Set the URL, user and password of your Telegram-Archive viewer. Docker Compose (HTTP on 127.0.0.1:8080) and local builds are in Getting started.

Documentation

The full documentation is at geiserx.github.io/telegram-archive-mcp.

  • Getting started: npm, Docker Compose, local build
  • Configuration: environment variables and client configuration
  • Usage: the 4 resources and 10 tools, paging, reading one day at a time
  • Development: testing, contributing, credits
  • Related projects: Telegram Archive, other MCP servers, where this one is listed

License

GPL-3.0-or-later

الأسئلة الشائعة

ما هو Telegram Archive؟

Search and read your archived Telegram chats and messages

كيف أثبّت Telegram Archive؟

يعمل على جهازك. في Claude Code: claude mcp add telegram-archive -e 'TELEGRAM_ARCHIVE_URL=<TELEGRAM_ARCHIVE_URL>' -e 'TELEGRAM_ARCHIVE_USER=<TELEGRAM_ARCHIVE_USER>' -e 'TELEGRAM_ARCHIVE_PASS=<your telegram_archive_pass>' -e 'READ_ONLY=<READ_ONLY>' -- npx -y telegram-archive-mcp@0.4.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Telegram Archive إلى مفتاح API؟

نعم. يتطلب TELEGRAM_ARCHIVE_URL, TELEGRAM_ARCHIVE_PASS، وتضبطها في إعداداته.

هل Telegram Archive مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص GPL-3.0.

من يصون Telegram Archive؟

ينشره GeiserX. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.