بناء عملاء MCP المتينين: إتقان مفاتيح الدائرة ومنطق إعادة المحاولة

يمثل بروتوكول سياق النموذج (MCP) تحولاً جذرياً في طريقة تفاعل وكلاء الذكاء الاصطناعي مع الأدوات ومصادر البيانات الخارجية. ومع نشر هذه الوكلاء عبر أنظمة موزعة، يصبح موثوقية اتصالات خوادم MCP عن بُعد أمراً بالغ الأهمية. يمكن أن يؤدي خلل شبكي عابر أو زيادة مؤقتة في حمل الخادم إلى انهيار كامل للوكيل إذا لم يتم التعامل معه بشكل صحيح. لبناء تطبيقات MCP بمستوى الإنتاج، يجب علينا تجاوز كتل "try-catch" البسيطة وتنفيذ أنماط صمود متطورة مثل مفاتيح الدائرة (Circuit Breakers) ومنطق إعادة المحاولة الذكي.

لماذا يُعد الصمود مهماً في MCP

في بنية MCP القياسية، يتواصل العميل (غالباً وكيل LLM) مع الخادم (مزود الأداة) عبر JSON-RPC فوق التدفقات. على عكس استدعاءات الدوال المحلية، يمكن أن تعاني خوادم MCP عن بُعد من تأخير الشبكة، وانتهاء المهلة الزمنية، واستنفاد الموارد. بدون آليات وقائية، يمكن أن يستهلك خادم معطل ميزانية المهلة الزمنية الكاملة للعميل، مما يؤدي إلى تأخيرات يواجهها المستخدم أو حالات توقف (Deadlocks). تضمن أنماط الصمود بقاء العميل متجاوباً وقادراً على تدهور الوظائف بسلاسة عندما تصبح أداة معينة غير متاحة.

تنفيذ منطق إعادة المحاولة مع التراجع الأسي

خط الدفاع الأول هو منطق إعادة المحاولة. ومع ذلك، يمكن أن تؤدي إعادة المحاولات الفورية البسيطة إلى إجهاد خادم يعاني بالفعل. بدلاً من ذلك، يجب علينا استخدام التراجع الأسي مع التذبذب (Jitter). تزيد هذه الاستراتيجية من وقت الانتظار بين المحاولات بشكل أسي، مما يقلل الحمل على الخادم مع السماح للمشاكل العابرة بالحل.

import { Client } from "@modelcontextprotocol/sdk/client";

async function retryWithBackoff<T>(
  fn: () => Promise<T>,
  maxRetries: number = 3,
  baseDelayMs: number = 100
): Promise<T> {
  let lastError: Error | null = null;

  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      lastError = error as Error;

      // Check if error is retryable (e.g., network timeout)
      if (!isRetryableError(error)) {
        throw error;
      }

      const delay = baseDelayMs * Math.pow(2, attempt);
      const jitter = Math.random() * 100;
      await new Promise(resolve => setTimeout(resolve, delay + jitter));
    }
  }
  throw new Error("Max retries exceeded") from lastError;
}

من الحاسم التمييز بين الأخطاء القابلة لإعادة المحاولة (انتهاء مهلة الشبكة، رموز الحالة 503) والأخطاء غير القابلة لإعادة المحاولة (400 طلب غير صالح، أخطاء الصياغة). إعادة محاولة الطلبات غير الصالحة تهدر الموارد فقط.

نمط مفتاح الدائرة (Circuit Breaker)

إعادة المحاولة وحدها غير كافية إذا كان الخادم متوقفاً. إذا كان الخادم غير قابل للوصول، فإن إعادة المحاولة ستؤخر الفشل فقط. هنا يبرز دور نمط مفتاح الدائرة. إنه يراقب صحة الاتصال و"يفتح" الدائرة، مما يمنع المزيد من الطلبات لفترة محددة. يسمح هذا للخادم بالوقت اللازم للتعافي ويمنع العميل من الانهيار تحت وطأة الطلبات المعلقة.

يتميز مفتاح الدائرة النموذجي بثلاث حالات:

1. مغلق: تشغيل طبيعي. الطلبات تمر عبره. يتم عدّ الفشل.
2. مفتوح: يتم رفض الطلبات فوراً. تستمر هذه الحالة لمدة "مهلة زمنية" محددة.
3. نصف مفتوح: بعد انتهاء المهلة، يُسمح بعدد محدود من طلبات الاختبار. إذا نجحت، تُغلق الدائرة؛ وإلا، تُفتح مرة أخرى.

class CircuitBreaker {
  private state: "closed" | "open" | "half-open" = "closed";
  private failureCount = 0;
  private lastFailureTime = 0;

  constructor(
    private failureThreshold: number = 5,
    private resetTimeoutMs: number = 10000
  ) {}

  async execute<T>(fn: () => Promise<T>): Promise<T> {
    if (this.state === "open") {
      if (Date.now() - this.lastFailureTime > this.resetTimeoutMs) {
        this.state = "half-open";
      } else {
        throw new Error("Circuit breaker is open");
      }
    }

    try {
      const result = await fn();
      this.handleSuccess();
      return result;
    } catch (error) {
      this.handleFailure();
      throw error;
    }
  }

  private handleSuccess() {
    this.failureCount = 0;
    this.state = "closed";
  }

  private handleFailure() {
    this.failureCount++;
    this.lastFailureTime = Date.now();

    if (this.failureCount >= this.failureThreshold) {
      this.state = "open";
    }
  }
}

دمج الاستراتيجيات لتحقيق أقصى قدر من الصمود

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

const breaker = new CircuitBreaker();
const safeCall = async (request: any) => {
  return breaker.execute(() => retryWithBackoff(() => client.send(request)));
};

الخاتمة

مع نمو اعتماد MCP، سيزيد تعقيد أنظمة الذكاء الاصطناعي الموزعة. تنفيذ مفاتيح الدائرة ومنطق إعادة المحاولة ليس مجرد ممارسة مثلى؛ بل هو ضرورة لبناء وكلاء ذكاء اصطناعي موثوقين بمستوى احترافي. من خلال إدارة حالات الفشل واستهلاك الموارد بشكل استباقي، تضمن بقاء عملاء MCP مستقرين ومتجاوبين ومتينين في مواجهة انقطاعات الشبكة والخدمات الحتمية.