/ الدليل / الملعب / excel-mcp-server
← كل الخوادم ↗ GitHub
● مجتمع haris-musa ⚡ فوري

excel-mcp-server

بواسطة haris-musa · haris-musa/excel-mcp-server

أنشئ واقرأ وعدل ملفات .xlsx حقيقية من المحادثة — معادلات وجداول ورسوم بيانية وجداول محورية وتنسيق شرطي.

excel-mcp-server (haris-musa) هو MCP مكتوب بلغة Python يعالج مصنفات Excel عبر openpyxl. يعمل على ملفات .xlsx محلية أو كخدمة HTTP بعيدة. يدعم المعادلات وإنشاء الرسوم البيانية والجداول المحورية والتنسيق والتحقق من صحة البيانات.

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

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

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

عرض مباشر

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

excel.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "excel",
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "excel": {
      "command": {
        "path": "uvx",
        "args": [
          "excel-mcp-server"
        ]
      }
    }
  }
}

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

claude mcp add excel -- uvx excel-mcp-server

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

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

استخدامات عملية: excel-mcp-server

كيفية إنشاء تقرير Excel شهري من موجه

👤 العمليات والمالية وأي شخص يرسل Excel إلى أصحاب المصلحة غير التقنيين ⏱ ~20 min intermediate

متى تستخدمه: في نهاية كل شهر عندما تحدث 'جدول البيانات الذي يطلبه الجميع'.

المتطلبات الأساسية
  • تثبيت uv — curl -LsSf https://astral.sh/uv/install.sh | sh
  • مصدر الحقيقة (ملف CSV أو استعلام قاعدة بيانات أو ملف الشهر السابق) — تصدير إلى CSV أو الدمج مع postgres MCP
الخطوات
  1. إنشاء المصنف
    أنشئ /reports/2026-04.xlsx مع أوراق 'Summary', 'Revenue', 'Costs', 'Charts'.✓ تم النسخ
    → تم إنشاء الملف وتوجد الأوراق
  2. ملء البيانات
    ملأ 'Revenue' من /data/apr-revenue.csv؛ أضف صف إجمالي باستخدام صيغ SUM.✓ تم النسخ
    → الصفوف والمجاميع موجودة
  3. إضافة الرسوم البيانية
    في علامة التبويب 'Charts' أضف رسم بياني خطي للإيرادات اليومية من 'Revenue' A2:B31 بعنوان 'April Revenue'.✓ تم النسخ
    → الرسم البياني مرئي عند الفتح في Excel
  4. التنسيق
    في 'Summary' غامق الرؤوس وطبق فواصل الآلاف للعملات والتنسيق الشرطي للقيم السالبة (الحمراء).✓ تم النسخ
    → ملف منسق بشكل احترافي

النتيجة: ملف .xlsx جاهز للمراجعة مع صيغ حية ورسوم بيانية.

المزالق
  • لصق 100 ألف صف عبر الموجه يفجر نافذة السياق — اجعل MCP يقرأ CSV مباشرة من القرص بدلاً من لصق القيم
  • الجداول المحورية المكتوبة بواسطة openpyxl لا تتحدث تلقائياً عند الفتح في بعض إصدارات Excel — أرشد المستخدمين إلى الضغط بزر الماوس الأيمن وتحديث؛ أو استخدم ملخص قائم على الصيغ بدلاً من ذلك
اجمعها مع: postgres · filesystem

كيفية استخراج الجداول من عرض Excel إلى markdown

👤 المهندسون الذين يحولون جداول البيانات المالية إلى مستندات ⏱ ~10 min beginner

متى تستخدمه: يرسل لك صاحب مصلحة مصنفاً وتحتاج إليه في wiki.

الخطوات
  1. تعداد الأوراق
    افتح /inbox/Q1-plan.xlsx واسرد الأوراق والأبعاد.✓ تم النسخ
    → فهرس الأوراق
  2. استخراج كل ورقة كـ markdown
    لكل ورقة اقرأ النطاق المستخدم وأعد تقديمه كجدول markdown.✓ تم النسخ
    → نص markdown جاهز للصق

النتيجة: جداول جاهزة لـ Wiki.

المزالق
  • الخلايا المدمجة تشوه عرض markdown — فك الدمج قبل التصدير أو تعامل مع المناطق المدمجة بشكل صريح
اجمعها مع: markdownify · notion

كيفية تنظيف ملف Excel فوضوي في عملية واحدة

👤 محررو البيانات ⏱ ~15 min intermediate

متى تستخدمه: يرسل لك شريك ورقة بتواريخ غير متسقة ومسافات بيضاء زائدة ورؤوس مكررة.

الخطوات
  1. تحديد المشاكل
    دقق في /inbox/vendors.xlsx — الأعمدة بأنواع مختلطة والمسافات البيضاء والصفوف المكررة.✓ تم النسخ
    → تقرير المشاكل
  2. تطبيق الإصلاحات
    احذف المسافات البيضاء وحلل العمود E كتواريخ ISO وأزل الصفوف المكررة بالكامل. احفظ إلى /cleaned/vendors.xlsx.✓ تم النسخ
    → تم حفظ الملف النظيف

النتيجة: مصنف نظيف جاهز للمعالجة.

المزالق
  • تصحيح التواريخ التي كانت نصاً متعمداً يفقد المعنى — تأكد من صاحب البيانات قبل التحويلات الجسيمة
اجمعها مع: postgres

التركيبات

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

excel + postgres

الاستعلام من قاعدة البيانات وكتابة النتيجة إلى Excel لأصحاب المصلحة

قم بتشغيل SELECT * FROM monthly_revenue WHERE month = '2026-04' واكتب النتيجة إلى /reports/apr.xlsx مع رسم بياني.✓ تم النسخ
excel + filesystem

معالجة كل ملف xlsx في مجلد على دفعات

لكل ملف في /inbox/vendors/ وحد الرؤوس إلى {vendor,sku,qty,price} واكتب إلى /cleaned/.✓ تم النسخ
excel + markdownify

تحويل جداول xlsx إلى مستندات markdown

استخرج كل ورقة من /inbox/plan.xlsx إلى أقسام markdown واكتب /docs/plan.md.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
create_workbook path: str بدء ملف .xlsx جديد free
create_worksheet path, name إضافة علامة تبويب free
write_data_to_excel path, sheet, start_cell, data: 2d array ملء نطاق free
read_data_from_excel path, sheet, range استخراج القيم free
apply_formula path, sheet, cell, formula إضافة صيغة free
create_chart path, sheet, chart_type, range, title إدراج رسم بياني free
create_pivot_table path, source, rows, cols, values تلخيص البيانات free
format_range path, sheet, range, styles التنسيق free
apply_conditional_formatting path, sheet, range, rule تلوين الخلايا free

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

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

حصة API
بدون حد — كل شيء محلي
الرموز لكل استدعاء
يعتمد على كمية البيانات التي تمر عبر الموجه؛ فضل عمليات مسار الملف
التكلفة المالية
مجاني (MIT)
نصيحة
اقرأ النطاقات وليس الأوراق بأكملها عندما يكون للملف 100 ألف+ صف.

الأمان

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

الحد الأدنى من الصلاحيات: قراءة وكتابة نظام الملفات إلى المجلد الذي يحتوي على المصنفات
تخزين بيانات الاعتماد: بدون
نقل البيانات الخارجي: إدخال/إخراج ملفات محلية فقط؛ البيانات تغادر آلتك فقط عبر مزود LLM الخاص بك
لا تمنح أبدًا: لا تمنح حق الكتابة خارج مجلد معزول عند تشغيل موجهات غير موثوقة

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

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

Permission denied writing file

برنامج آخر فتح الملف (غالباً Excel نفسه). أغلقه وحاول مرة أخرى.

تحقق: lsof path/to/file.xlsx
Formula stored as text

ضع بادئة للسلاسل التي تبدأ بـ '=' عبر apply_formula، وليس write_data_to_excel.

Chart doesn't render in Excel

تحقق من أن نطاق البيانات يغطي أعمدة المصدر مع الرؤوس؛ يحتاج Excel إلى صفين على الأقل.

File saved but Excel says 'corrupted'

عادة ما يكون من مزج write_data والصيغ في نفس الخلية. أعد إنشاء الملف من الأسفل إلى الأعلى.

البدائل

excel-mcp-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Google Sheets عبر google-workspace MCPتريد أوراق سحابية تعاونية وليس .xlsx محليةيحتاج OAuth؛ ليس بديلاً عن xlsx محلي
LibreOffice headless MCPتحتاج إلى تنفيذ ماكرو أو التحويل إلى PDFتثبيت ثقيل؛ أبطأ

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills