freemcplab / الدليل / الملعب / Telegram MCP (MTProto)

● مجتمع sparfenyuk ⚡ فوري

Telegram MCP (MTProto)

Name: Telegram MCP (MTProto) MCP Server
Author: sparfenyuk

بواسطة sparfenyuk · sparfenyuk/mcp-telegram

Telegram MCP server using MTProto — read/send messages on real user accounts (not just bot API), search dialogs, browse channels.

Telegram MCP (MTProto) is a Model Context Protocol server maintained by sparfenyuk. Telegram MCP server using MTProto — read/send messages on real user accounts (not just bot API), search dialogs, browse channels. See README for installation and configuration: https://github.com/sparfenyuk/mcp-telegram

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

Telegram MCP server using MTProto — read/send messages on real user accounts (not just bot API), search dialogs, browse channels.
Language: Python
175+ GitHub stars at verification time
Community project

عرض مباشر

كيف يبدو في الممارسة

telegram-mcp-mtproto.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "telegram-mcp-mtproto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "telegram-mcp-mtproto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "telegram-mcp-mtproto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "telegram-mcp-mtproto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "telegram-mcp-mtproto",
      "command": "npx",
      "args": [
        "-y",
        "mcp-telegram"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "telegram-mcp-mtproto": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-telegram"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add telegram-mcp-mtproto -- npx -y mcp-telegram

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Telegram MCP (MTProto)

Use Telegram MCP (MTProto) for its primary workflow

👤 Claude Code users ⏱ ~20 min intermediate

متى تستخدمه: See repo README for canonical use cases.

المتطلبات الأساسية

Repo cloned or installed — See https://github.com/sparfenyuk/mcp-telegram

الخطوات

Install

Install Telegram MCP (MTProto) per README.✓ تم النسخ

→ Tool registered with client
Configure

Provide credentials/config as instructed.✓ تم النسخ

→ Successful auth/init
Use

Run a sample task with Telegram MCP (MTProto).✓ تم النسخ

→ Expected output

النتيجة: You can drive the documented workflow end-to-end.

المزالق

Skipping README — Read the repo README and CHANGELOG before shipping to prod.

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
primary	see README	Primary action	free

التكلفة والحدود

تكلفة التشغيل

حصة API: None of its own; bounded by upstream provider quotas if any
الرموز لكل استدعاء: Depends on usage
التكلفة المالية: Open source — check repo LICENSE
نصيحة: Review upstream API costs (if any) before automating.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: Whatever the upstream provider requires

تخزين بيانات الاعتماد: Env vars or local config — never commit secrets

نقل البيانات الخارجي: Forwards data per its README

لا تمنح أبدًا: Full admin to untrusted prompts

Project moves fast — pin a version in production.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Auth fails

Verify credentials and required scopes match README.

تحقق: Re-read repo README auth section.

Tool not found by client

Ensure MCP client config points to correct command/path.

تحقق: Restart the client after editing config.