telegram-archive-mcp
功能概览
类型 | 用途 | MCP URI / 工具 ID |
资源 | 只读浏览归档统计信息、聊天记录和文件夹 |
|
工具 | 搜索和检索消息,检查聊天统计信息 |
|
所有功能均通过单个 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 监听地址 (Docker 设置为 |
| (空 = HTTP) | 设置为 |
将它们放入 .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 -- 轻松实现多架构发布
维护者
贡献
欢迎参与!提交 Issue 或提交 PR。
Telegram-Archive-MCP 遵循 Contributor Covenant 行为准则。
GeiserX 的其他 MCP 服务器
cashpilot-mcp — 被动收入监控
duplicacy-mcp — 备份健康监控
genieacs-mcp — TR-069 设备管理
lynxprompt-mcp — AI 配置蓝图
pumperly-mcp — 燃油和电动汽车充电价格
相关项目
项目 | 描述 |
带有本地 Web 查看器的自动化增量 Telegram 备份 | |
在频道之间以可配置延迟转发消息的 Telegram 机器人 | |
通过 Telegram 机器人与 Soulseek 进行自动化音乐发现和下载 | |
完全通过 Telegram 管理 Paperless-NGX 文档 | |
用于 Telegram-Archive 的 n8n 社区节点 |
Maintenance
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
- AlicenseNot gradedqualityDmaintenanceMCP 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.2MIT
- FlicenseNot gradedqualityCmaintenanceAn 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.
- AlicenseNot gradedqualityBmaintenanceAn 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.9MIT
- AlicenseAqualityCmaintenanceA local MCP server that enables full-text and semantic search over your own Telegram chats using your personal MTProto login, with everything running locally.7MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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