Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Telegram MCP

by n24q02m
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Better Telegram MCP

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

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

CI codecov PyPI Docker License: MIT

Python Telegram MCP semantic-release Renovate

功能特性

  • 双模式 -- 用于机器人的 Bot API (httpx) 和用于用户账户的 MTProto (Telethon)

  • 6 个工具，支持动作分发：message、chat、media、contact、config、help

  • 自动检测模式 -- 设置机器人令牌以使用机器人模式，或设置 API 凭据以使用用户模式

  • 基于 Web 的 OTP 认证 -- 基于浏览器的身份验证，支持无头环境的远程中继

  • 工具注解 -- 每个工具都声明了 readOnlyHint、destructiveHint、idempotentHint、openWorldHint

  • MCP 资源 -- 文档以 telegram://docs/* 资源形式提供

  • 安全加固 -- SSRF 防护、路径遍历预防、错误信息脱敏

Related MCP server: Telegram MCP Server & Channel Monitor

设置

使用 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

--

任何主题的完整文档

MCP 资源

URI

内容

telegram://docs/messages

消息操作参考

telegram://docs/chats

聊天管理参考

telegram://docs/media

媒体发送/下载参考

telegram://docs/contacts

联系人管理参考

telegram://stats

所有文档汇总

安全性

  • SSRF 防护 -- 所有 URL 均针对内部/私有 IP 范围进行验证，阻止 DNS 重绑定

  • 路径遍历预防 -- 验证文件路径，阻止访问敏感目录

  • 会话文件安全 -- 600 权限，仅通过 Web UI 进行 2FA（从不存储在环境变量中）

  • 错误脱敏 -- 错误消息中绝不泄露凭据

从源码构建

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

许可证

MIT -- 参见 LICENSE。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers

  • telegram-bot-mcp

    FantomaSkaRus1
    A
    license
    B
    quality
    C
    maintenance
    Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API — messages, chats, stickers, payments, forums, stories, and more.
    100
    31 npm
    7
    MIT

  • Telegram MCP Server & Channel

    ruchiayeon
    A
    license
    A
    quality
    D
    maintenance
    A comprehensive MCP server providing 35 tools for managing Telegram messages, media, and chat interactions via the Bot API. It also features a real-time monitoring system using the Telethon User API to log messages from specific channels.
    35
    Apache 2.0

  • tg-mcp-guarded

    matskevich
    A
    license
    Not graded
    quality
    C
    maintenance
    Dual-plane Telegram MCP server providing read-only analytics and guarded write actions with built-in rate limiting, anti-spam protection, and session management.
    9
    MIT