خادم MCP الخاص بتليجرام

ماذا يفعل خادم “MCP” لتليجرام؟

يقوم خادم MCP الخاص بتليجرام بدمج إمكانيات منصة تليجرام القوية مع بروتوكول Model Context Protocol (MCP)، مما يمكّن المساعدات الذكية والعملاء من التفاعل برمجياً مع تليجرام. باستخدام مكتبة Telethon، يسمح هذا الخادم بأتمتة شاملة وإدارة للدردشات، والرسائل، والمجموعات، وتفاعلات المستخدمين ضمن تليجرام. يعمل كجسر بين وكلاء الذكاء الاصطناعي وواجهة برمجة تطبيقات تليجرام، مما يتيح تنفيذ مهام مثل إرسال الرسائل، واسترجاع سجلات الدردشات، وإدارة المجموعات، وأكثر من ذلك. هذا يعزز بشكل كبير تدفقات تطوير البرمجيات من خلال تسهيل التواصل، وتوفير الردود الآلية، وأدوات للاستعلام أو تعديل بيانات تليجرام مباشرة من أدوات مدعومة بالذكاء الاصطناعي مثل Claude، وCursor، وغيرهم من العملاء المتوافقين مع MCP.

قائمة القوالب الجاهزة (Prompts)

لم يتم ذكر أي قوالب جاهزة في الوثائق المتوفرة أو ملفات المستودع.

قائمة الموارد

لم يتم توثيق أو ذكر أي موارد MCP صريحة في الملفات أو ملف README المتوفر.

قائمة الأدوات

• get_chats(page, page_size): يعيد قائمة دردشات ومجموعات تليجرام المتاحة للمستخدم المصادق عليه بشكل مجزأ (paginated). يتيح ذلك للعملاء ونماذج الذكاء الاصطناعي استعراض واختيار سجل محادثات المستخدم لمزيد من التحليل أو المراسلة.

تشير الوثائق إلى أن “كل ميزة رئيسية في تليجرام/Telethon متاحة كأداة”، لكن فقط get_chats تم ذكرها صراحة. القائمة الكاملة للأدوات غير متوفرة في الوثائق المرئية.

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

• المراسلة الآلية: يمكن لوكلاء الذكاء الاصطناعي إرسال رسائل أو وسائط أو ملفات إلى أفراد أو مجموعات على تليجرام، مما يتيح الإشعارات والردود أو البث البرمجي.
• تحليل الدردشات: استرجاع وتحليل سجلات الدردشة لتلخيص النقاشات أو استخراج المهام أو إجراء تحليل للمشاعر داخل مجموعات أو محادثات تليجرام الخاصة.
• إدارة المجموعات: إدارة عضوية المجموعات، والأدوار، والأذونات بشكل برمجي لإدارة المجتمعات أو الفرق بكفاءة.
• تكامل البوتات: استخدم الخادم لتشغيل بوتات تليجرام تنفذ تدفقات عمل معقدة، أو تنقل المعلومات، أو تعمل كمساعدات افتراضية مدعومة بالذكاء الاصطناعي.
• استخراج البيانات بسلاسة: استخراج رسائل أو ملفات أو تفاصيل دردشة محددة للتكامل مع أنظمة خارجية أو لوحات تحكم أو قواعد بيانات لدعم الأتمتة المتقدمة.

كيفية الإعداد

Windsurf

1. المتطلبات الأساسية: تأكد من تثبيت Node.js وإعداد Windsurf.
2. تحديد ملف الإعدادات: افتح إعدادات أو ملف إعدادات Windsurf.
3. إضافة خادم MCP: أدرج خادم MCP الخاص بتليجرام إلى قسم mcpServers:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ إعداداتك وأعد تشغيل Windsurf.
5. التحقق من الإعداد: تحقق من لوحة تحكم Windsurf أو السجلات للتأكد من تشغيل telegram-mcp.

تأمين مفاتيح API (مثال)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Claude

1. المتطلبات الأساسية: تأكد من تثبيت Claude Desktop أو عميل متوافق مع Claude.
2. تحديد ملف الإعداد: حرر ملف claude_desktop_config.json.
3. إضافة إدخال خادم MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ ملف JSON وأعد تشغيل Claude.
5. التحقق: تأكد من أن Claude يكتشف ويتصل بـ telegram-mcp.

تأمين مفاتيح API (مثال)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cursor

1. المتطلبات الأساسية: ثبّت Node.js ومحرر Cursor.
2. فتح إعدادات Cursor: الوصول إلى قسم تكامل MCP.
3. إضافة خادم MCP لتليجرام:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. إعادة تشغيل Cursor: احفظ الإعدادات وأعد تشغيل التطبيق.
5. التحقق: تأكد من أن Cursor يتعرف ويتصل بخادم MCP الخاص بتليجرام.

تأمين مفاتيح API (مثال)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cline

1. المتطلبات الأساسية: تأكد من تثبيت Cline وإعداده.
2. فتح ملف الإعدادات: حرر إعدادات أو ملف إعدادات Cline الخاص بك.
3. إدراج إدخال خادم MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ الملف وأعد تشغيل Cline.
5. التحقق: تحقق من واجهة Cline للتأكد من تشغيل خادم MCP الخاص بتليجرام.

تأمين مفاتيح API (مثال)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

كيفية استخدام هذا MCP ضمن التدفقات

استخدام MCP في فلوهانت

لدمج خوادم MCP في تدفق عملك على فلوهانت، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق JSON:

{
  "telegram-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بمجرد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع إمكانية الوصول إلى جميع وظائفه وإمكانياته. تذكر تغيير “telegram-mcp” إلى الاسم الفعلي لخادم MCP الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

دعم الجذور: لا يوجد ذكر صريح
دعم التقطيع: لا يوجد ذكر صريح

أقيّم خادم MCP الخاص بتليجرام بـ 6 من 10. إنه قوي وظيفياً مع تعليمات إعداد وأمان واضحة، لكنه يفتقر إلى توثيق حول القوالب الجاهزة، والموارد الصريحة، وقائمة أدوات شاملة، وهي عناصر مهمة لتكامل MCP المتقدم والشفافية.

تقييم MCP