sparfenyuk/mcp-telegram

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

190 stars 37 forks 品質 68 トレンド 17MIT

Repository Install

sparfenyuk/mcp-telegramは、https://github.com/sparfenyuk/mcp-telegram.からインポートされたMCPサーバー候補です。

概要

sparfenyuk/mcp-telegramは、https://github.com/sparfenyuk/mcp-telegram.からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

Telegram MCPサーバー
概要
MCPって何?
このサーバーは何をしているの?
実用的なユースケース
前提条件
設置
構成
Telegram API 設定
Claudeデスクトップ構成
テレグラム構成
開発
始めて
ターミナルでのサーバーデバッグ
インスペクターでのサーバーデバッグ
トラブルシューティング
メッセージ「MCPサーバーに接続できません」 mcp-telegram

概要

このサーバーはTelegram APIとAIアシスタントの間の橋渡し役であり、モデルコンテキストプロトコルに基づいています。

[!重要] このサーバーを使用する前に、Telegram API利用規約を読み理解していることを確実にしてください。 Telegram APIの不正使用はアカウントの停止につながる可能性があります。

MCPとは何か?

モデルコンテキストプロトコル(MCP)は、Claude DesktopのようなAIアプリが外部ツールやデータソースに接続できるようにするシステムです。これは、AIアシスタントがローカルサービスやAPIと明確かつ安全に連携しつつ、ユーザーがコントロールできる方法を提供します。

このサーバーは何をしているの?

現時点では、サーバーはTelegram APIへの読み取り専用アクセスを提供しています。

[x] ダイアログ(チャット、チャンネル、グループ)のリストを取得

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Telegram MCP server

Telegram MCP server

About

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.

What is MCP?

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do?

As of not, the server provides read-only access to the Telegram API.

[x] Get the list of dialogs (chats, channels, groups)
[x] Get the list of (unread) messages in the given dialog
[ ] Mark chanel as read
[ ] Retrieve messages by date and time
[ ] Download media files
[ ] Get the list of contacts
[ ] Draft a message
…

Practical use cases

[x] Create a summary of the unread messages
[ ] Find contacts with upcoming birthdays and schedule a greeting
[ ] Find discussions on a given topic, summarize them and provide a list of links

Prerequisites

uv tool

Installation

uv tool install git+https://github.com/sparfenyuk/mcp-telegram

[!NOTE] If you have already installed the server, you can update it using uv tool upgrade --reinstall command.

[!NOTE] If you want to delete the server, use the uv tool uninstall mcp-telegram command.

Configuration

Telegram API Configuration

Before you can use the server, you need to connect to the Telegram API.

Get the API ID and hash from Telegram API
Run the following command:

GitHub で README 全文を見る

インストール

npx @modelcontextprotocol/inspector uv run mcp-telegram

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
      "mcpServers": {
        "mcp-telegram": {
            "command": "mcp-server",
            "env": {
              "TELEGRAM_API_ID": "<your-api-id>",
              "TELEGRAM_API_HASH": "<your-api-hash>",
            },
          }
        }
      }
    }