@huggingface/mcp-client

عميل بروتوكول سياق النموذج (MCP).

توفر هذه الحزمة تطبيقًا للعميل للتفاعل مع خوادم MCP، مبنيًا فوق @huggingface/inference الخاص بنا.

يتضمن مثالًا لوكيل سطر أوامر (CLI) صغير يمكنه الاستفادة من أدوات MCP.

التثبيت

يُعد هذا الحزمة جزءًا من مستودع Hugging Face JS الموحّد. لتثبيت التبعيات لجميع الحزم، نفّذ الأمر التالي من جذر المستودع:

pnpm install

الاستخدام (وكيل سطر الأوامر)

يتضمن الحزمة وكيلًا لواجهة سطر الأوامر (CLI) يوضح كيفية استخدام عميل MCP.

المتطلبات

• Hugging Face API Token: تحتاج إلى رمز API من Hugging Face مع الصلاحيات المناسبة. اضبطه كمتغير بيئة:
  تم النسخ

  export HF_TOKEN="hf_..."

تشغيل الوكيل

انتقل إلى دليل الحزمة وشغّل سكربت الوكيل:

cd packages/mcp-client
pnpm agent

أو، شغّل الأمر من جذر المستودع الموحّد:

pnpm --filter @huggingface/mcp-client agent

سيحمّل الوكيل أدوات MCP المتاحة (افتراضيًا، بالاتصال بخادم نظام ملفات لسطح مكتبك وخادم Playwright) ويطالبك بإدخال (>).

الإعدادات (متغيرات البيئة)

• HF_TOKEN (اختياري): رمز API الخاص بك في Hugging Face. مطلوب إذا كنت تستخدم مزود استدلال على HF.
• MODEL_ID (اختياري): معرّف النموذج المستخدم لاستدلال الوكيل. القيمة الافتراضية هي Qwen/Qwen2.5-72B-Instruct.
• PROVIDER (اختياري): مزود الاستدلال. القيمة الافتراضية هي together. راجع @huggingface/inference لمعرفة المزودين المتاحين.
• ENDPOINT_URL أو BASE_URL (اختياري): عنوان URL أساسي مخصص (محلي على سبيل المثال) للاستدعاء.

مثال مع نموذج مخصص:

export HF_TOKEN="hf_..."
export MODEL_ID="Qwen/Qwen2.5-72B-Instruct"
pnpm agent

التطوير

يمكن تنفيذ مهام التطوير الشائعة باستخدام سكربتات pnpm:

• pnpm build: بناء الحزمة.
• pnpm lint: فحص وتصحيح نمط الكتابة.
• pnpm format: تنسيق الكود باستخدام Prettier.
• pnpm test: تشغيل الاختبارات باستخدام Vitest.
• pnpm check: فحص أنواع الكود باستخدام TypeScript.

رخصة

MIT