Better Telegram MCP

Name: Better Telegram MCP
Author: n24q02m

mcp-name: io.github.n24q02m/better-telegram-mcp

支持双模式的 Telegram MCP 服务器：用于快速机器人集成的 Bot API (httpx) 和用于完整用户账户访问的 MTProto (Telethon)。

功能特性

双模式 -- 用于机器人的 Bot API (httpx) 和用于用户账户的 MTProto (Telethon)
6 个工具，支持动作分发：message、chat、media、contact、config、help
自动检测模式 -- 设置机器人令牌以使用机器人模式，或设置 API 凭据以使用用户模式
基于 Web 的 OTP 认证 -- 基于浏览器的身份验证，支持无头环境的远程中继
工具注解 -- 每个工具都声明了 readOnlyHint、destructiveHint、idempotentHint、openWorldHint
MCP 资源 -- 文档以 telegram://docs/* 资源形式提供
安全加固 -- SSRF 防护、路径遍历预防、错误信息脱敏

使用 AI Agent -- 复制并发送此内容给您的 AI Agent：

请为我设置 better-telegram-mcp。请遵循此指南： https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

手动设置 -- 请遵循 docs/setup-manual.md

工具	动作	描述
`message`	`send`, `edit`, `delete`, `forward`, `pin`, `react`, `search`, `history`	发送、编辑、删除、转发消息。置顶、反应、搜索、浏览历史记录
`chat`	`list`, `info`, `create`, `join`, `leave`, `members`, `admin`, `settings`, `topics`	列出并管理聊天、群组、频道。成员、管理员、论坛主题
`media`	`send_photo`, `send_file`, `send_voice`, `send_video`, `download`	发送照片、文件、语音笔记、视频。从消息中下载媒体
`contact`	`list`, `search`, `add`, `block`	列出、搜索、添加联系人。拉黑/解除拉黑用户（仅限用户模式）
`config`	`status`, `set`, `cache_clear`, `setup_status`, `setup_start`, `setup_reset`, `setup_complete`	服务器状态、运行时设置、缓存、凭据设置（中继、状态、重置、完成）
`help`	--	任何主题的完整文档

git clone https://github.com/n24q02m/better-telegram-mcp.git
cd better-telegram-mcp
uv sync
uv run better-telegram-mcp

MIT -- 参见 LICENSE。

-

security - not tested

A

license - permissive license

-

quality - not tested