Telegram MCP 服务器

一个使用 Python、Telethon 和 MCP Python SDK 构建的 Telegram MCP (模型上下文协议) 服务器。此 MCP 服务器提供简单的工具，用于直接通过 MCP 兼容的主机（例如 Claude for Desktop）与 Telegram 聊天进行交互。

提供的工具

• get_chats: 检索分页的 Telegram 聊天列表。
• get_messages: 检索来自特定聊天的分页消息。
• send_message: 向特定聊天发送消息。

要求

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

安装和设置

克隆仓库

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

创建环境变量文件

复制并重命名 .env.example 为 .env，并使用从 https://my.telegram.org/apps 获取的 Telegram 凭据填充它：

cp .env.example .env

你的 .env 文件应如下所示：

TELEGRAM_API_ID=your_api_id_here
TELEGRAM_API_HASH=your_api_hash_here
TELEGRAM_SESSION_NAME=your_session_name

设置 Python 环境

使用 uv 设置 Python 环境并安装依赖项：

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

运行服务器 (首次身份验证)

首次运行服务器时，Telethon 将提示你输入 Telegram 身份验证代码：

uv run main.py

通过输入发送到你的 Telegram 客户端的代码进行身份验证。 此步骤仅需要一次。

与 Claude for Desktop 集成

macOS/Linux

编辑你的 Claude Desktop 配置：

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加此 MCP 服务器配置：

{
    "mcpServers": {
        "telegram-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE_PATH/telegram-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

确保将 /ABSOLUTE_PATH/telegram-mcp 替换为你的项目的绝对路径。

Windows

编辑你的 Claude Desktop 配置：

nano $env:AppData\Claude\claude_desktop_config.json

添加此 MCP 服务器配置：

{
    "mcpServers": {
        "telegram-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE_PATH\\telegram-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

确保将 C:\ABSOLUTE_PATH\telegram-mcp 替换为你的项目的绝对路径。

用法

集成后，你的 Telegram 工具（get_chats、get_messages 和 send_message）将在 Claude for Desktop UI 或任何其他 MCP 兼容的客户端中可用。

许可证

本项目根据 Apache 2.0 许可证 获得许可。