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 传输运行它。至少需要一个 已发布的版本

本地构建

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

贡献

欢迎参与!提交 Issue 或提交 PR。

Telegram-Archive-MCP 遵循 Contributor Covenant 行为准则。

GeiserX 的其他 MCP 服务器

相关项目

项目

描述

Telegram-Archive

带有本地 Web 查看器的自动化增量 Telegram 备份

telegram-delay-channel-cloner

在频道之间以可配置延迟转发消息的 Telegram 机器人

telegram-slskd-local-bot

通过 Telegram 机器人与 Soulseek 进行自动化音乐发现和下载

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