Skip to content

Latest commit

 

History

History
161 lines (108 loc) · 8.57 KB

README.md

File metadata and controls

161 lines (108 loc) · 8.57 KB

الاختبار وتصحيح الأخطاء

قبل أن تبدأ في اختبار خادم MCP الخاص بك، من المهم أن تفهم الأدوات المتاحة وأفضل الممارسات لتصحيح الأخطاء. يضمن الاختبار الفعّال أن يعمل الخادم كما هو متوقع ويساعدك على تحديد المشكلات وحلها بسرعة. يوضح القسم التالي الطرق الموصى بها للتحقق من صحة تنفيذ MCP الخاص بك.

نظرة عامة

تتناول هذه الدرس كيفية اختيار النهج المناسب للاختبار وأداة الاختبار الأكثر فاعلية.

أهداف التعلم

بنهاية هذا الدرس، ستكون قادرًا على:

  • وصف مختلف الطرق للاختبار.
  • استخدام أدوات مختلفة لاختبار الكود بفعالية.

اختبار خوادم MCP

يوفر MCP أدوات تساعدك في اختبار وتصحيح خوادمك:

  • MCP Inspector: أداة سطر أوامر يمكن تشغيلها كأداة CLI أو كأداة بصرية.
  • الاختبار اليدوي: يمكنك استخدام أداة مثل curl لإجراء طلبات ويب، لكن أي أداة تدعم HTTP ستفي بالغرض.
  • الاختبار الوحدوي: من الممكن استخدام إطار الاختبار المفضل لديك لاختبار ميزات كل من الخادم والعميل.

استخدام MCP Inspector

لقد شرحنا استخدام هذه الأداة في دروس سابقة، لكن دعنا نتحدث عنها بشكل عام. هي أداة مبنية على Node.js ويمكنك استخدامها عبر استدعاء الأمر npx الذي سيقوم بتنزيل الأداة وتثبيتها مؤقتًا ثم تنظيف نفسه بعد الانتهاء من تنفيذ طلبك.

تساعدك MCP Inspector على:

  • اكتشاف قدرات الخادم: الكشف التلقائي عن الموارد والأدوات والمطالبات المتاحة
  • اختبار تنفيذ الأدوات: تجربة معلمات مختلفة ورؤية الاستجابات في الوقت الحقيقي
  • عرض بيانات وصفية للخادم: فحص معلومات الخادم، المخططات، والإعدادات

يبدو تشغيل الأداة النموذجي كما يلي:

npx @modelcontextprotocol/inspector node build/index.js

الأمر أعلاه يبدأ MCP وواجهته البصرية ويطلق واجهة ويب محلية في متصفحك. يمكنك توقع رؤية لوحة تحكم تعرض خوادم MCP المسجلة، الأدوات المتاحة، الموارد، والمطالبات. تتيح الواجهة اختبار تنفيذ الأدوات بشكل تفاعلي، فحص بيانات الخادم، وعرض الاستجابات في الوقت الحقيقي، مما يسهل التحقق وتصحيح تنفيذات خادم MCP الخاصة بك.

هذا ما قد تبدو عليه الواجهة: Inspector

يمكنك أيضًا تشغيل هذه الأداة في وضع CLI بإضافة الخاصية --cli. إليك مثالًا لتشغيل الأداة في وضع "CLI" الذي يعرض جميع الأدوات على الخادم:

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

الاختبار اليدوي

بجانب تشغيل أداة inspector لاختبار قدرات الخادم، هناك طريقة مشابهة وهي تشغيل عميل قادر على استخدام HTTP مثل curl.

مع curl، يمكنك اختبار خوادم MCP مباشرة باستخدام طلبات HTTP:

# Example: Test server metadata
curl http://localhost:3000/v1/metadata

# Example: Execute a tool
curl -X POST http://localhost:3000/v1/tools/execute \
  -H "Content-Type: application/json" \
  -d '{"name": "calculator", "parameters": {"expression": "2+2"}}'

كما ترى من استخدام curl أعلاه، تستخدم طلب POST لاستدعاء أداة مع حمولة تتكون من اسم الأداة ومعلماتها. استخدم الطريقة التي تناسبك أكثر. أدوات CLI عمومًا أسرع في الاستخدام وتميل لأن تكون قابلة للبرمجة النصية، وهو ما يمكن أن يكون مفيدًا في بيئة CI/CD.

الاختبار الوحدوي

أنشئ اختبارات وحدوية لأدواتك ومواردك لضمان عملها كما هو متوقع. إليك مثال على كود اختبار.

import pytest

from mcp.server.fastmcp import FastMCP
from mcp.shared.memory import (
    create_connected_server_and_client_session as create_session,
)

# Mark the whole module for async tests
pytestmark = pytest.mark.anyio


async def test_list_tools_cursor_parameter():
    """Test that the cursor parameter is accepted for list_tools.

    Note: FastMCP doesn't currently implement pagination, so this test
    only verifies that the cursor parameter is accepted by the client.
    """

 server = FastMCP("test")

    # Create a couple of test tools
    @server.tool(name="test_tool_1")
    async def test_tool_1() -> str:
        """First test tool"""
        return "Result 1"

    @server.tool(name="test_tool_2")
    async def test_tool_2() -> str:
        """Second test tool"""
        return "Result 2"

    async with create_session(server._mcp_server) as client_session:
        # Test without cursor parameter (omitted)
        result1 = await client_session.list_tools()
        assert len(result1.tools) == 2

        # Test with cursor=None
        result2 = await client_session.list_tools(cursor=None)
        assert len(result2.tools) == 2

        # Test with cursor as string
        result3 = await client_session.list_tools(cursor="some_cursor_value")
        assert len(result3.tools) == 2

        # Test with empty string cursor
        result4 = await client_session.list_tools(cursor="")
        assert len(result4.tools) == 2

يقوم الكود السابق بما يلي:

  • يستخدم إطار pytest الذي يتيح لك إنشاء اختبارات كدوال واستخدام عبارات assert.
  • ينشئ خادم MCP مع أداتين مختلفتين.
  • يستخدم عبارة assert للتحقق من تحقق شروط معينة.

اطلع على الملف الكامل هنا

بناءً على الملف أعلاه، يمكنك اختبار خادمك الخاص لضمان إنشاء القدرات كما ينبغي.

جميع SDKs الرئيسية تحتوي على أقسام اختبار مماثلة بحيث يمكنك التكيف مع بيئة التشغيل التي تختارها.

عينات

موارد إضافية

ما التالي

إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.