خادم عينات S3 MCP

ماذا يفعل خادم “عينات S3” MCP؟

خادم عينات S3 MCP هو تنفيذ لبروتوكول سياق النماذج (MCP) صُمم لربط المساعدين والوكلاء الذكيين مع البيانات المخزنة في دلاء AWS S3. من خلال إتاحة موارد S3 كمصادر وأدوات MCP، يمكّن سير عمل قائم على الذكاء الاصطناعي من استرجاع الملفات وإدارتها والتفاعل معها—خاصة مستندات PDF—المحفوظة في S3. هذا يمنح المطورين وأدوات الذكاء الاصطناعي القدرة على تنفيذ مهام مثل عرض الدلاء، تعداد العناصر، واسترجاع المستندات، مما يعزز الإنتاجية والأتمتة مباشرة في بيئات التطوير التي تتطلب الوصول إلى ملفات سحابية. الخادم مفيد بشكل خاص لإثراء سياق الذكاء الاصطناعي ببيانات خارجية، ويدعم حالات استخدام متقدمة في تحليل المستندات والبحث المؤسسي وغيرها.

قائمة المطالبات

لم يتم العثور على معلومات في المستودع بخصوص قوالب المطالبات.

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

• بيانات AWS S3 (مستندات PDF):
  • يتيح مستندات PDF المخزنة في دلاء AWS S3 كمصادر MCP. يمكن تحميل هذه الموارد في سياق نموذج لغوي كبير (LLM) لمزيد من المعالجة أو التحليل.
  • يدعم عرض حتى 1,000 عنصر في كل طلب.

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

• ListBuckets
  • يُرجع قائمة بجميع دلاء S3 المملوكة لحساب AWS المصادق عليه.
• ListObjectsV2
  • يسترجع حتى 1,000 عنصر (ملف) من دلو S3 محدد في طلب واحد.
• GetObject
  • يُنزل أو يسترجع عنصرًا معينًا (مثل PDF) من دلو S3 معين عبر المفتاح.

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

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

كيفية إعداده

Windsurf

لم يتم العثور على تعليمات إعداد خاصة بـ Windsurf.

Claude

1. المتطلبات الأساسية: قم بتثبيت الخادم وتأكد من تهيئة بيانات اعتماد AWS (access key, secret, region) مع أذونات S3 مناسبة.
2. تحديد موقع التكوين:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. إضافة خادم MCP إلى التكوين:
   مثال لخادم تطوير/غير منشور:

   {
     "mcpServers": {
       "s3-mcp-server": {
         "command": "uv",
         "args": [
           "--directory",
           "/Users/user/generative_ai/model_context_protocol/s3-mcp-server",
           "run",
           "s3-mcp-server"
         ]
       }
     }
   }
   

   مثال لخادم منشور:

   {
     "mcpServers": {
       "s3-mcp-server": {
         "command": "uvx",
         "args": [
           "s3-mcp-server"
         ]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ ملف التكوين وأعد تشغيل Claude Desktop.
5. التحقق من الإعداد: تأكد من ظهور خادم S3 MCP في قائمة الأدوات المتاحة.

تأمين مفاتيح API

حدد بيانات اعتماد AWS باستخدام متغيرات البيئة أو ملف بيانات اعتماد AWS (راجع وثائق إعداد AWS CLI). مثال:

{
  "env": {
    "AWS_ACCESS_KEY_ID": "your-access-key",
    "AWS_SECRET_ACCESS_KEY": "your-secret-key",
    "AWS_DEFAULT_REGION": "your-region"
  },
  "inputs": {}
}

Cursor

لم يتم العثور على تعليمات إعداد لـ Cursor.

Cline

لم يتم العثور على تعليمات إعداد لـ Cline.

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

استنادًا إلى المعلومات المقدمة وبنية المستودع، فإن خادم عينات S3 MCP يعد خادم MCP مركزًا وذو نطاق واضح لاسترجاع وإدارة ملفات PDF المعتمدة على S3. يغطي المبادئ الأساسية لـ MCP (الموارد، الأدوات)، ويوفر تعليمات إعداد واضحة لـ Claude، ويتبع ممارسات جيدة للأمان والترخيص. ومع ذلك، يفتقر إلى تفاصيل حول المطالبات، والعينات، ودعم المنصات مثل Windsurf وCursor.

أقيّم هذا الخادم MCP بدرجة 7 من 10 نظرًا لوضوح تكامله مع S3 وتوفيره للأدوات والموارد، مع وجود بعض النواقص في التوثيق والميزات لتغطية البروتوكول بشكل أوسع.

تقييم MCP