Telegram MCP Server

A Model Context Protocol (MCP) server for Telegram, built with Telethon and FastMCP.

Features

• MTProto Support: High-performance communication via Telethon.
• FastMCP: Seamless integration with AI agents.
• Async & Performance: Optimized for speed and concurrency.
• Professional Core: Built-in logging, caching, and configuration.

Setup

1. Install uv if you haven't already.
2. Clone the repository.
3. Create a .env file based on .env.example:

   cp .env.example .env
   

4. Fill in your API_ID and API_HASH from my.telegram.org.
5. Install dependencies:

   uv sync
   

Usage

Run the MCP server:

uv run python -m telegram_mcp.server

Structure

• src/telegram_mcp/core/: Essential utilities (logger, cache, config).
• src/telegram_mcp/service/: Business logic and external API clients.
• src/telegram_mcp/models/: Pydantic data models.
• src/telegram_mcp/server.py: MCP server definition and tool registration.