telegram-mcp

要求

• Python 项目管理器，UV
• MCP 客户端

使用方法

1. 安装依赖

pip3 install uv
uv venv
source .venv/bin/activate
uv sync

2. 编辑 .env 文件，添加你的 Telegram API ID 和哈希值 (我的 Telegram)，不要与他人分享。

3. 启动 HTTP 服务器

uv run http-server/http-server.py

4. 安装 MCP 服务器

uv run mcp install mcp-server/mcp-server.py

可用功能

MCP 服务器提供以下功能：

• get_unread_entities: 获取有未读消息的实体
• get_unread_messages(id): 根据给定的实体ID获取所有未读消息
• get_messages(id, count): 根据实体ID获取限定数量的消息
• get_entities: 获取当前会话中的所有实体
• get_entity_by_id(id): 根据ID获取当前会话中的实体
• send_message(entity_id, content, reply_to_message_id): 向实体发送消息，可选带有回复和标记

常见问题及解决办法

• Claude 无法运行 MCP 服务器 >> 使用 brew 安装 uv: brew install uv
• 无法在 Telegram 中创建新应用 >> 断开 VPN 并重试

许可证

MIT