telegram-desktop-mcp

# Telegram MCP Server Telegram MCP server scaffold that logs in to Telegram using a QR code before starting the MCP server. This project uses: - `telethon` to connect to Telegram - `qrcode` to print a login QR code in the terminal - `python-dotenv` to load private keys from a local `.env` file > مهم: لا ترفع مفاتيح Telegram الخاصة بك أو ملف `.session` إلى GitHub. ## Requirements - Python 3.10+ - Telegram account - Telegram API credentials from <https://my.telegram.org> ## 1. Get Telegram API ID and API Hash 1. Open <https://my.telegram.org> 2. Login with your Telegram phone number 3. Go to **API development tools** 4. Create an app 5. Copy: - `api_id` - `api_hash` ## 2. Install dependencies Create and activate a virtual environment: ```bash python -m venv .venv source .venv/bin/activate ``` Install packages: ```bash pip install telethon qrcode python-dotenv ``` ## 3. Configure environment variables Copy the example file: ```bash cp .env.example .env ``` Edit `.env`: ```env TELEGRAM_API_ID=123456 TELEGRAM_API_HASH=your_api_hash_here TELEGRAM_SESSION=telegram_mcp ``` Replace the values with your real Telegram credentials. ## 4. How QR login works When the server starts, it checks if your Telegram session is already authorized. - If authorized, it continues normally. - If not authorized, it prints a QR code in the terminal. To login: 1. Open Telegram on your phone 2. Go to **Settings** 3. Go to **Devices** 4. Tap **Link Desktop Device** 5. Scan the QR code from the terminal After scanning, a `.session` file is created locally. This file keeps you logged in. ## 5. Run Current `server.py` contains the login helper and Telegram client setup. If your MCP server has a main function, call this before starting MCP: ```python await before_mcp_start() ``` Example: ```python async def main(): await before_mcp_start() await mcp.run_async() ``` Then run: ```bash python server.py ``` ## Project files ```text server.py # Telegr…