Каталог MCP
GeiserX/telegram-archive-mcp

GeiserX/telegram-archive-mcp

Name: GeiserX/telegram-archive-mcp
Availability: InStock
Author: geiserx

Telegram-Archive-MCP — мост, который превращает любой экземпляр Telegram-Archive в MCP-сервер. LLM и агенты могут искать сообщения, просматривать чаты и статистику архива через единый JSON-RPC эндп...

Github NPM Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

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:

У этого сервера пока нет списка инструментов.

`0.3.0`основная	16.10.2026
`0.2.0`	16.10.2026
`0.1.3`	05.10.2026
`0.1.1`	26.04.2026
`0.1.0`	03.04.2026
`0.0.2`	03.04.2026
`0.0.1`	03.04.2026

Выберите клиент, чтобы установить GeiserX/telegram-archive-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "geiserx-telegram-archive-mcp-3f0k4ctd9p": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "telegram-archive-mcp"
      ],
      "env": {
        "TELEGRAM_ARCHIVE_URL": "http://localhost:8000",
        "TELEGRAM_ARCHIVE_USER": "admin",
        "TELEGRAM_ARCHIVE_PASS": "your-viewer-password"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"geiserx-telegram-archive-mcp-3f0k4ctd9p\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"telegram-archive-mcp\"],\"env\":{\"TELEGRAM_ARCHIVE_URL\":\"http://localhost:8000\",\"TELEGRAM_ARCHIVE_USER\":\"admin\",\"TELEGRAM_ARCHIVE_PASS\":\"your-viewer-password\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add geiserx-telegram-archive-mcp-3f0k4ctd9p --env TELEGRAM_ARCHIVE_URL=http://localhost:8000 --env TELEGRAM_ARCHIVE_USER=admin --env TELEGRAM_ARCHIVE_PASS=your-viewer-password -- npx -y telegram-archive-mcp

Либо через JSON-конфиг:

claude mcp add-json geiserx-telegram-archive-mcp-3f0k4ctd9p "{\"command\":\"npx\",\"args\":[\"-y\",\"telegram-archive-mcp\"],\"env\":{\"TELEGRAM_ARCHIVE_URL\":\"http://localhost:8000\",\"TELEGRAM_ARCHIVE_USER\":\"admin\",\"TELEGRAM_ARCHIVE_PASS\":\"your-viewer-password\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add geiserx-telegram-archive-mcp-3f0k4ctd9p --env TELEGRAM_ARCHIVE_URL=http://localhost:8000 --env TELEGRAM_ARCHIVE_USER=admin --env TELEGRAM_ARCHIVE_PASS=your-viewer-password -- npx -y telegram-archive-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.geiserx-telegram-archive-mcp-3f0k4ctd9p]
command = "npx"
args = ["-y", "telegram-archive-mcp"]

[mcp_servers.geiserx-telegram-archive-mcp-3f0k4ctd9p.env]
TELEGRAM_ARCHIVE_URL = "http://localhost:8000"
TELEGRAM_ARCHIVE_USER = "admin"
TELEGRAM_ARCHIVE_PASS = "your-viewer-password"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите GeiserX/telegram-archive-mcp, а в поле команды запуска — строку ниже:

npx -y telegram-archive-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например geiserx-telegram-archive-mcp-3f0k4ctd9p.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: geiserx-telegram-archive-mcp-3f0k4ctd9p
    command: npx
    args:
      - "-y"
      - "telegram-archive-mcp"
    env:
      TELEGRAM_ARCHIVE_URL: http://localhost:8000
      TELEGRAM_ARCHIVE_USER: admin
      TELEGRAM_ARCHIVE_PASS: your-viewer-password

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx