使用说明

项目简介

Telegram MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 Anthropic 的 Claude 桌面应用提供 Telegram 集成能力。通过此服务器，用户可以使用 Claude 与 Telegram 账户进行交互，实现如收发消息、管理联系人等功能。

主要功能点

聊天管理：
- 获取聊天列表（支持分页）
- 获取详细的聊天信息
消息功能：
- 获取聊天消息（支持分页和多种过滤条件，如关键词、日期范围）
- 发送消息到指定聊天
- 获取消息上下文
联系人管理：
- 搜索联系人（通过姓名、用户名或电话号码）
- 获取与联系人的私聊会话
- 获取联系人参与的所有会话（包括群组）
- 查看与联系人的最近互动

安装步骤

克隆仓库

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

生成 Session String 运行 'python session_string_generator.py'，按照提示输入您的电话号码和验证码，生成 Session String。此步骤用于安全地验证您的 Telegram 账户。

配置环境变量 创建 '.env' 文件，并填入您的 Telegram API ID、API Hash 和上一步生成的 Session String。您可以在 my.telegram.org/apps 获取 API ID 和 API Hash。

TELEGRAM_API_ID=your_api_id_here
TELEGRAM_API_HASH=your_api_hash_here
TELEGRAM_SESSION_STRING=your_session_string_here

安装依赖

uv venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows
uv add "mcp[cli]" telethon python-dotenv nest_asyncio

配置 Claude 桌面应用 编辑 Claude 桌面应用的配置文件 'claude_desktop_config.json'，根据您的操作系统，文件路径可能如下：

macOS/Linux: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

在 'mcpServers' 中添加 'telegram-mcp' 服务器配置。请务必将 'command' 和 'args' 中的路径替换为您的实际路径。

{
    "mcpServers": {
        "telegram-mcp": {
            "command": "/full/path/to/uv",  // 替换为 uv 可执行文件的完整路径，例如 /Users/your_username/.local/bin/uv 或 C:\\Users\\YourUsername\\.venv\\Scripts\\uv.exe
            "args": [
                "--directory",
                "/full/path/to/telegram-mcp-server", // 替换为 telegram-mcp 仓库的完整路径，例如 /Users/your_username/telegram-mcp 或 C:\\Users\\YourUsername\\telegram-mcp
                "run",
                "main.py"
            ]
        }
    }
}

基本使用方法

配置完成后，启动 Claude 桌面应用。Claude 将能够通过 Telegram MCP Server 与您的 Telegram 账户互动。您可以使用自然语言指令，例如：

"显示我最近的聊天记录"
"给聊天ID为 123456789 的用户发送消息 '你好！'"
"搜索联系人 '张三'"

具体的使用示例和指令可以参考仓库的 README 文档。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息