article
README
🚀 Telegram MCP 服务器
这是一个简单的 Telegram MCP 服务器,允许 Claude 访问你的 Telegram 账户,实现读取和发送消息的功能。
🚀 快速开始
本服务器允许 Claude 访问你的 Telegram 账户,实现消息的读取与发送。下面为你详细介绍使用步骤。
✨ 主要特性
get_chats:获取你 Telegram 账户的聊天列表。send_message:向某个聊天发送消息。get_message:从聊天中获取并打印未读消息。mark_messages_read:将消息标记为已读。get_conversation_context:获取过去 20 条消息,并根据convostyle.txt中的内容确定合适的回复语气。
📦 安装指南
推荐设置方法
步骤 1:获取你的 Telegram API 凭证
- 访问 https://my.telegram.org/apps。
- 登录并创建一个应用(若已有账户可直接使用)。注意:选择“web”类型即可,无需其他特殊设置。
- 记下你的 API 编号 和 API 哈希值。
步骤 2:配置 Python 环境
- 安装所需的包(在终端中输入以下命令):
pip install python-telegram-bot
- 创建并激活虚拟环境(以 Ubuntu/Debian 系统为例):
python3 -m venv venv
source venv/bin/activate
步骤 3:配置 Telegram MCP 服务器
- 在项目目录中创建
config.py文件,并添加以下内容:
# config.py
BOT_TOKEN = 'your_bot_token'
ADMINS = ['your_telegram_id']
- 启动服务器:
python main.py
📚 详细文档
高级配置
你可以在 convostyle.txt 中自定义聊天机器人回复的语气和风格,使其更贴近你的表达方式。
完成上述步骤后,重启你的 Telegram 应用或机器人程序以应用所有更改。
⚠️ 重要提示
- 确保在
config.py中填写正确的 Bot Token 和管理员 ID。- 启动服务器前,请确保你已安装所有必要的依赖项。
- 如果遇到任何问题,请检查日志文件以获取更多信息。
扫码联系在线客服