إنشاء خادم أدوات MCP للقراءة فقط لاستعلامات الوكيل

الهدف

توفير استعلامات MCP قابلة للاكتشاف ومقيدة ودون آثار كتابة.

الخطوات

1. اختر استعلام أعمال للقراءة فقط وامنح أقل صلاحيات قراءة في طبقة البيانات. [mcp-tools] [mcp-errors]
2. سجّل باستخدام @mcp.tool() وتلميحات الأنواع؛ وقيّد الصفحات عبر Annotated[int, Field(ge=1, le=50)]. [mcp-tools] [mcp-errors]
3. إذا ضبطت read_only_hint=True فاعتبره تلميحاً للعميل فقط؛ وفرض القراءة فقط عبر صلاحيات قاعدة البيانات أو الخدمة. [mcp-tools] [mcp-errors]
4. حوّل الاستثناءات إلى أخطاء MCP مضبوطة ولا تُعد تتبعات المكدس أو سلاسل الاتصال أو الأسرار. [mcp-tools] [mcp-errors]
5. اختبر طلبات صالحة وغير مخوّلة وغير صالحة وبصفحات مفرطة وتأكد من أن طبقة البيانات ترفض الكتابة. [mcp-tools] [mcp-errors]

طريقة التحقق

ينبغي أن تثبت الاختبارات أن الأداة تقرأ النطاق المصرح به فقط وأن الأخطاء لا تكشف تفاصيل داخلية.

معالجة الأعطال

إذا استطاع الاختبار تغيير البيانات، ففرض صلاحيات القراءة فقط في طبقة البيانات بدلاً من الاعتماد على وصف الأداة.