Office PowerPoint MCP

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

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

إنشاء .pptx جديد أو فتح وتعديل العروض الموجودة
إضافة شرائح من أسماء التخطيطات (Title, Content, Section Header)
إدراج إطارات نصية بتحكم كامل في الخط والنمط
إضافة مخططات أصيلة (عمودي، شريطي، خطي، دائري) من البيانات
إدراج الصور مع التحجيم والتموضع

عرض مباشر

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

office-powerpoint-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

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

{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "office-powerpoint-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "office-powerpoint-mcp",
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "office-powerpoint-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "office-powerpoint-mcp-server",
          "ppt_mcp_server"
        ]
      }
    }
  }
}

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

claude mcp add office-powerpoint-mcp -- uvx --from office-powerpoint-mcp-server ppt_mcp_server

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

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

استخدامات عملية: Office PowerPoint MCP

تحويل مخطط Markdown إلى عرض شرائح منقّح

👤 كل من يقدّم أبحاثاً أو حالات أو عروضاً ⏱ ~30 min beginner

متى تستخدمه: لديك ملاحظات أو مستند وتحتاج إلى شرائح بحلول صباح الغد.

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

المخطط المصدر — ملف Markdown بتسلسل هرمي H1/H2

الخطوات

اختيار قالب أساسي

Use ppt-mcp. Open ~/templates/corporate.pptx and list the available layouts.✓ تم النسخ

→ قائمة التخطيطات (Title Slide, Section Header, Content, Two Content)
تعيين المخطط إلى شرائح

Read outline.md. Each H1 is a section header slide; each H2 is a content slide. Bullet content under each H2.✓ تم النسخ

→ ملخص الخطة: N رؤوس أقسام، M شرائح محتوى
التصيير والمراجعة

Build the deck and save as deck-2026-04-27.pptx. Then read back the slide count and titles for sanity check.✓ تم النسخ

→ العرض محفوظ؛ العناوين تطابق المخطط

النتيجة: عرض جاهز للتحسين في PowerPoint بدلاً من البناء من الصفر.

المزالق

القالب المخصص يستخدم أسماء تخطيطات غير معيارية — أدرج التخطيطات أولاً؛ عيّن بالفهرس إذا كانت الأسماء غامضة

اجمعها مع: office-word-mcp

توليد مخططات من البيانات وتضمينها في العرض

👤 المحللون الذين يُحدّثون التقارير ربع السنوية ⏱ ~25 min intermediate

متى تستخدمه: الأرقام تتغير كل ربع سنة؛ التنسيق ثابت.

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

البيانات المصدر بصيغة CSV أو مضمّنة — أي تنسيق جدولي يمكن لـ Claude قراءته

الخطوات

اختيار نوع المخطط لكل مقياس

From q1-data.csv, decide chart type per metric (revenue → bar, growth-rate → line, segment-mix → pie).✓ تم النسخ

→ تعيين لكل مقياس
إدراج المخططات كعناصر أصيلة

Add each chart on its own slide with the metric name as title. Use the Two Content layout.✓ تم النسخ

→ عناصر مخطط أصيلة (قابلة للتعديل في PowerPoint) لا صور نقطية

النتيجة: مخططات قابلة للتعديل في العرض؛ يمكن للمستلم التعمق فيها.

المزالق

بيانات المخطط لا تُحدَّث عند تغيير المصدر — أعد تشغيل المولّد كل ربع سنة؛ المخططات مدمجة في .pptx

إضافة ملاحظات المتحدث لكل شريحة بناءً على المحتوى

👤 المقدّمون الذين يريدون نصاً بجودة مُوجِّه للتلاوة ⏱ ~20 min beginner

متى تستخدمه: ستقدّم دون تحضير وتحتاج إلى نص لكل شريحة.

الخطوات

قراءة محتوى الشريحة

Open the deck. For each slide, extract the visible bullets.✓ تم النسخ

→ المحتوى مُدرج لكل شريحة
توليد الملاحظات

Write 60-second speaker notes per slide. Conversational, no jargon. Save into the speaker-notes pane.✓ تم النسخ

→ لوحة الملاحظات مملوءة لكل شريحة

النتيجة: العرض يصبح سكريبت تقديم أيضاً.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

office-powerpoint-mcp + office-word-mcp

توليد تقرير وعرض مطابق من مصدر واحد

Build the long-form .docx via word-mcp, then generate the executive readout .pptx via ppt-mcp from the same outline.✓ تم النسخ

office-powerpoint-mcp + filesystem

قراءة البيانات المصدر من القرص قبل تصيير العرض

Read q1-data.csv via filesystem, then build the deck with charts.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها
create_presentation	filename, template_path?	بدء عرض جديد
add_slide	filename, layout_name	كل شريحة جديدة
set_slide_title	filename, slide_index, title	ملء العنصر النائب للعنوان
add_text_box	filename, slide_index, text, x, y, w, h	طبقة نصية مخصصة
add_chart	filename, slide_index, type, data, position	تصور البيانات
add_image	filename, slide_index, image_path, x, y	وضع الصور
set_speaker_notes	filename, slide_index, text	تحضير المتحدث لكل شريحة

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

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

حصة API: غير متاح — محلي
الرموز لكل استدعاء: 100–600 لكل استدعاء
التكلفة المالية: مجاني (MIT)
نصيحة: ابنِ الشرائح واحدة تلو الأخرى بدلاً من تفريغ خطة العرض بالكامل في موجه واحد

الأمان

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

الحد الأدنى من الصلاحيات: filesystem-read filesystem-write

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: لا شيء

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

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

التخطيط غير موجود

تتباين أسماء التخطيطات بين القوالب؛ أدرج list_layouts أولاً لحصر الأسماء الدقيقة

المخطط يبدو فارغاً

python-pptx يستخدم مراجع مخططات XML؛ تأكد أن بيانات جدول البيانات الأساسية غير فارغة

الصورة أكبر من الشريحة

مرّر العرض والارتفاع الصريحين بوحدة EMU؛ استخدم مساعدات pptx.util.Inches()

البدائل