MCP Telegram Server

Name: MCP Telegram Server
Author: leshchenko1979

@leshchenko1979

リポジトリ

MCP Telegram Server について

Telegram MCP Server - now you can talk to your Telegram from Cursor

#telegram #mcp #cursor #claude #telethon #cursor-ai #mcp-server

基本情報

カテゴリ

コミュニケーション

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

leshchenko1979

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "tg_mcp": {
      "command": "python",
      "args": [
        "setup_telegram.py"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP Telegram Server?

MCP Telegram Server is an MCP (Model Control Protocol) server that provides Telegram functionality through a clean API interface, including message search, sending, and chat management capabilities. It is built for MCP‑compatible environments like Cursor IDE and allows AI agents to interact with Telegram chats programmatically.

How to use MCP Telegram Server?

Clone the repository, install dependencies with pip install -r requirements.txt, create a .env file with your Telegram API credentials, and run python setup_telegram.py to authenticate. Then start the server with mcp run <path>/server.py. For Cursor IDE, add the server to a .cursor/mcp.json file. After configuration, all Telegram tools are available inside the IDE.

Key features of MCP Telegram Server?

Message search with basic, advanced, and regex pattern modes
Send messages with optional reply support
List, manage, and generate links for Telegram chats
Chat statistics and data export functionality
Robust error handling and logging
Built on the MCP architecture for AI integration

Use cases of MCP Telegram Server?

Search and retrieve messages from Telegram chats using text or patterns
Send automated messages or replies to specific chats
Export chat data for analysis or backup
Integrate Telegram tools into MCP‑compatible development environments
Monitor chat statistics and generate message links

FAQ from MCP Telegram Server

What are the prerequisites for running MCP Telegram Server?

You need Python 3.x, Telegram API credentials (API_ID, API_HASH, PHONE_NUMBER), and an MCP‑compatible environment (e.g., Cursor IDE).

How do I authenticate with Telegram?

Run python setup_telegram.py from the project root. This creates a session file (mcp_telegram_search.session) that stores your authenticated session.

What tools does the server expose?

It provides search_messages, advanced_search, pattern_search, send_telegram_message, get_dialogs, get_statistics, generate_links, and export_data – all via MCP tools.

Where is session and data stored locally?

An authenticated session file (mcp_telegram_search.session) is created in the project root. Logs are stored in the logs/ directory.

How do I configure for Cursor IDE?

Create a .cursor/mcp.json file with the server definition (command pointing to mcp run and the server script path). The server will connect automatically when the project is opened in Cursor.