OverleafMCP (MCP server) — حالات الاستخدام, التثبيت & عرض مباشر

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

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

قراءة شجرة المشروع والملفات .tex الفردية
تحليل LaTeX إلى شجرة أقسام/أقسام فرعية
دفع التعديلات عبر جسر Git الخاص بـ Overleaf (دون مخاطر الكتابة الفوقية)
فحص Bibtex لعمل الاقتباسات
يعمل مع أي مستوى Overleaf مدفوع يكشف Git

عرض مباشر

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

overleaf-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

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

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "overleaf-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "overleaf-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mjyoo2/overleaf-mcp"
        ]
      }
    }
  }
}

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

claude mcp add overleaf-mcp -- npx -y @mjyoo2/overleaf-mcp

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

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

استخدامات عملية: OverleafMCP

تضمين قسم ورقة بحثية دون مغادرة Claude

👤 الباحثون والكتّاب التقنيون ⏱ ~20 min intermediate

متى تستخدمه: المراجع رقم 2 قال إن القسم الثالث مطوّل — لديك 30 دقيقة لإصلاحه.

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

مستوى Overleaf مدفوع مع وصول Git — Account → Account Settings → Git authentication

الخطوات

التحديد

Use Overleaf MCP. Find section 3 in main.tex. Show me current text.✓ تم النسخ

→ نص القسم مُعاد مع نطاق السطور
إعادة الصياغة

Tighten this 30%. Keep technical terms intact. Don't drop citations.✓ تم النسخ

→ إعادة صياغة أقصر مع الحفاظ على الاقتباسات
الدفع

Replace section 3 with the rewrite. Commit with message 'Tighten §3 per reviewer 2'.✓ تم النسخ

→ دفع Git نجح؛ المشروع يُعاد رسمه في Overleaf

النتيجة: التعديلات تصل إلى Overleaf؛ لم تلمس واجهة الويب.

المزالق

التعديلات المتزامنة من مؤلف مشارك تُسبّب تعارضًا — اسحب قبل الدفع؛ حل التعارضات في Claude مع سياق diff

اجمعها مع: filesystem

مراجعة الاقتباسات في ورقة بحثية

👤 المؤلفون الذين ينهون مخطوطة ⏱ ~15 min beginner

متى تستخدمه: قبل التقديم — تريد التأكد من أن كل \cite له مدخل مقابل في .bib.

الخطوات

الجرد

List every \cite{} key in main.tex. Cross-check against refs.bib.✓ تم النسخ

→ جدول مطابقة؛ المفاتيح اليتيمة مُعلَّمة
الإصلاح

For each orphan key, suggest the closest match from .bib or mark as missing.✓ تم النسخ

→ توصية لكل مفتاح يتيم

النتيجة: صفر اقتباسات معطوبة قبل النقر على إرسال.

المزالق

الاقتباسات داخل التعليقات لا تزال تُطابَق — احذف تعليقات LaTeX قبل تطبيق regex

إعادة ترتيب الأقسام بثقة

👤 المؤلفون الذين يعيدون هيكلة الفصول ⏱ ~30 min advanced

متى تستخدمه: تدفق الأقسام خاطئ؛ تريد تبادل الأقسام 2 و4.

الخطوات

الرسم

Show me the section tree of main.tex with line ranges.✓ تم النسخ

→ شجرة هرمية
إعادة الترتيب

Swap section 2 with section 4. Update internal references (\ref) accordingly.✓ تم النسخ

→ التبادل مكتمل؛ المراجع مُتحقَّق منها

النتيجة: الورقة المُعاد هيكلتها تُصرَّف بنظافة.

المزالق

المراجع الأمامية تنكسر — صرَّف بعد إعادة الترتيب؛ Claude يستطيع قراءة الأخطاء وإصلاحها

التركيبات

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

overleaf-mcp + filesystem

نسخ احتياطي محلي للورقة قبل التعديلات الهيكلية

Snapshot the project to /papers/backup/ before any structural changes.✓ تم النسخ

overleaf-mcp + github

المزامنة مع GitHub لمراجعة مُتتبَّعة بـ issues

Push the same commits to my GitHub mirror so co-authors can leave PR comments.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
list_files	(none)	اكتشاف تخطيط المشروع	free
read_file	path	جلب ملف .tex/.bib للفحص	free
parse_structure	path	استعراض البنية قبل التعديل	free
edit_section	path, section_id, new_text	استبدال جراحي	free
git_push	message	حفظ التعديلات في Overleaf	free

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

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

حصة API: Git في Overleaf محدود المعدل (كن معتدلًا)
الرموز لكل استدعاء: 500–10000 بحسب حجم الملف
التكلفة المالية: MCP مجاني؛ مستوى Overleaf المدفوع مطلوب لـ Git
نصيحة: اقرأ الأقسام لا الملفات كاملة عند التكرار

الأمان

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

الحد الأدنى من الصلاحيات: Overleaf Git token — repo-level read/write

تخزين بيانات الاعتماد: متغير البيئة OVERLEAF_GIT_TOKEN

نقل البيانات الخارجي: git.overleaf.com

لا تمنح أبدًا: Token access to other people's projects

الـ tokens محدودة بالمشروع؛ دوّرها حين يتغير حاملها

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

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

Authentication failed during git_push

قد يكون token منتهيًا؛ أعد التوليد في إعدادات Overleaf

تحقق: git ls-remote مع نفس URL+token

Tree-sitter LaTeX errors on parse

بعض الماكروهات تُربك المحلل؛ ارجع إلى read_file + النطاق اليدوي

Push rejected (non-fast-forward)

مؤلف مشارك دفع؛ اسحب أولًا، حل التعارضات، ادفع مرة أخرى

البدائل

OverleafMCP مقابل البدائل

البديل	متى تستخدمها	المقايضة
VimTeX / TeXShop locally	لا تحتاج مزامنة سحابية إطلاقًا	لا تعاون Overleaf
Overleaf web editor	تعديلات خفيفة فقط	لا وصول agent؛ يدوي

OverleafMCP

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

استخدامات عملية: OverleafMCP

تضمين قسم ورقة بحثية دون مغادرة Claude

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

الخطوات

المزالق

مراجعة الاقتباسات في ورقة بحثية

الخطوات

المزالق

إعادة ترتيب الأقسام بثقة

الخطوات

المزالق

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

OverleafMCP مقابل البدائل

المزيد

الموارد