عن المشروع

خادم Excel MCP هو خادم بروتوكول سياق النموذج (Model Context Protocol) يمنح مساعدي الذكاء الاصطناعي القدرة على إنشاء مصنفات Excel وقراءتها وتحريرها. لا يتطلب تثبيت Microsoft Excel. يعمل مع ملفات ‎.xlsx‎ و‎.xlsm‎ (مع الحفاظ على وحدات الماكرو) و‎.xltx‎ و‎.xltm‎. القدرات - قراءة وكتابة الخلايا والصيغ والتواريخ، مع ترقيم الصفحات للأوراق الكبيرة والبحث في الخلايا. - تنسيق الخطوط والتعبئات والحدود وتنسيقات الأرقام وعروض الأعمدة والأجزاء المثبتة. - إدارة البنية: الأوراق والصفوف والأعمدة والخلايا المدمجة والجداول والمخططات وجداول الملخص. - تطبيق القواعد: التنسيق الشرطي والتحقق من البيانات مثل القوائم المنسدلة وحدود الأرقام. - قراءة كود VBA في ملفات ‎.xlsm‎ وحدة بوحدة (للقراءة فقط، ولا يُنفَّذ أبدًا). ميزات الأمان - حصر اختياري للمجلدات عبر ‎--allow-dir‎ أو ‎EXCEL_FILES_PATH‎؛ تُحل المسارات النسبية داخل المجلدات المسموح بها. - فحص أمان الصيغ يرفض الدوال التي تصل إلى الشبكة أو برامج أخرى أو معلومات المضيف (مثل WEBSERVICE وHYPERLINK وIMAGE وRTD وCALL وINFO وINDIRECT)، وروابط DDE، ومراجع المصنفات الخارجية. - وضع القراءة فقط، وحد أقصى لحجم الملف (افتراضيًا 100 ميغابايت)، وحد 100,000 خلية لكل استدعاء، وحفظ ذري. - وضع HTTP يستمع على localhost افتراضيًا؛ يتطلب الوصول عن بُعد رمز bearer ويوصى باستخدام وكيل عكسي يُنهي TLS. الإعداد عادةً ما يشغّل العملاء الخادم بالأمر uvx excel-mcp-server stdio، مع خيار ‎--allow-dir‎. تشمل التكاملات الموثقة Claude Desktop (بما في ذلك حزمة ‎.mcpb‎) وClaude Code وCursor وVS Code مع GitHub Copilot وOpenAI Codex وGemini CLI وDevin Desktop. يتوفر وضع Streamable HTTP، مع دعم Docker. تشمل مجالات الأدوات المصنفات (إنشاء، وصف، سرد، تصدير، استيراد)، والأوراق (وصف، إنشاء، إعادة تسمية، نسخ، حذف، إدراج/حذف صفوف أو أعمدة)، والخلايا (read_range، write_range، clear_range، copy_range، find_cells)، والتنسيق (format_range، merge_cells، set_sheet_layout، add_conditional_format، add_data_validation)، والكائنات (create_table، create_chart، create_summary_table)، ووحدات الماكرو (read_vba). القيود - تُخزَّن الصيغ ولا تُحسب؛ يعيد وضع القيم النتائج التي حفظها Excel آخر مرة، لذا تُقرأ الصيغ المكتوبة حديثًا كفارغة حتى تُفتح وتُحفظ في Excel أو LibreOffice. - لا تُدعم ملفات ‎.xls‎ و‎.csv‎ القديمة. - يكتب create_summary_table ملخصًا ثابتًا؛ ولا تُنشأ جداول PivotTables حقيقية. - إدراج أو حذف الصفوف والأعمدة لا يحدّث الصيغ أو المخططات أو الجداول التي تشير إلى خلايا منقولة. - قد تُفقد الميزات التي لا يفهمها openpyxl، مثل الأشكال والمقسمات وبعض الكائنات المضمنة، عند التحرير؛ وتُحفظ الصور والمخططات والجداول ووحدات الماكرو في ملفات ‎.xlsm‎. أعاد الإصدار 1.0 تسمية الأدوات وإعادة تصميمها، وأزال نقل SSE ويتطلب Python 3.11 أو أحدث. مرخّص بموجب MIT.