Telegram MCP Server

基本能力

产品定位

Telegram MCP Server 是一个用于与 Telegram 聊天进行交互的 MCP 服务器，旨在通过 MCP 兼容的主机提供便捷的 Telegram 聊天管理功能。

核心功能

• get_chats: 获取分页的 Telegram 聊天列表。
• get_messages: 从特定聊天中获取分页的消息。
• send_message: 向特定聊天发送消息。

适用场景

• 通过 MCP 兼容的主机（如 Claude for Desktop）管理 Telegram 聊天。
• 自动化 Telegram 消息的发送和接收。
• 集成 Telegram 聊天功能到其他 MCP 兼容的应用中。

工具列表

• get_chats: 获取用户的 Telegram 聊天列表，支持分页。
• get_messages: 从指定的聊天中获取消息，支持分页。
• send_message: 向指定的聊天发送消息。

常见问题解答

• 如何获取 Telegram API ID 和 Hash？ 访问 https://my.telegram.org/apps 获取。
• 如何首次认证？ 首次运行服务器时，Telethon 会提示输入 Telegram 认证代码，该代码会发送到你的 Telegram 客户端。

使用教程

使用依赖

• Python 3.10 或更高版本
• Telethon 包
• MCP Python SDK
• UV（可选但推荐）

安装教程

1. 克隆仓库

git clone https://github.com/chigwell/telegram-mcp
cd telegram-mcp

1. 创建环境文件

cp .env.example .env

1. 填写 .env 文件

TELEGRAM_API_ID=your_api_id_here
TELEGRAM_API_HASH=your_api_hash_here
TELEGRAM_SESSION_NAME=your_session_name

1. 设置 Python 环境

uv venv
source .venv/bin/activate
uv add "mcp[cli]" telethon python-dotenv nest_asyncio

1. 运行服务器（首次认证）

uv run main.py

调试方式

• 确保 .env 文件中的 Telegram API ID 和 Hash 正确。
• 首次运行时，确保输入正确的 Telegram 认证代码。
• 检查服务器日志以排查问题。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。