Telegram-Archive-MCP
A tiny bridge that exposes any Telegram-Archive instance as an MCP server, enabling LLMs to search messages, browse chats, and access archived Telegram history.
______________________________________________________________________
你得到了什么
| 类型 | 用途 | MCP URI/工具id |
|---|---|---|
| 资源 | 以只读方式浏览存档统计数据、聊天记录和文件夹 | telegram-archive://stats |
telegram-archive://chats telegram-archive://folders telegram-archive://health | | 工具 |搜索和检索消息，检查聊天统计数据| search_messages get_messages get_pinned_messages get_messages_by_date get_chat_stats get_topics refresh_stats |
所有内容都通过单个JSON-RPC端点公开(/mcp). LLM/代理人可以： initialize -> readResource -> listTools -> callTool …等等。
______________________________________________________________________
快速入门（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 Release为您的平台下载预构建的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 | 电报存档实例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)或者将它们置于环境中。
测试
经过测试 检查员 目前，它正在全面运作。在进行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"
}学分
电报档案 --电报消息存档和搜索
MCP-GO --现代MCP实施
GoRelease --无痛多弓松解术
维护者
@盖泽尔.
贡献
尽情潜水吧！ 打开一个问题 或提交PR。
电报档案MCP遵循 贡献者契约 行为准则。
GeiserX的其他MCP服务器
- 现金飞行员mcp --被动收入监测
- 重复 --备份健康监控
- 生殖细胞mcp --TR-069设备管理
- lynxprompt-mcp --AI配置蓝图
- 泵式mcp --燃料和电动汽车充电价格
相关项目
| 项目 | 描述 |
|---|---|
| 电报档案 | 使用本地web查看器进行自动增量Telegram备份 |
| 电报延迟信道克隆器 | Telegram机器人，在具有可配置延迟的通道之间中继消息 |
| 电报slskd本地机器人 | 使用Soulseek通过Telegram机器人自动发现和下载音乐 |
| 无纸电报机器人 | 完全通过Telegram管理无纸化NGX文档 |
| n8n节点电报存档 | 用于Telegram Archive的n8n社区节点 |