# @huggingface/mcp-client

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

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

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

## التثبيت

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

```bash
pnpm install
```

## Usage (وكيل سطر الأوامر)

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

### المتطلبات

*   **رمز واجهة برمجة تطبيقات Hugging Face:** تحتاج إلى رمز واجهة برمجة تطبيقات Hugging Face مع الصلاحيات المناسبة. اضبطه كمتغير بيئة:
    ```bash
    export HF_TOKEN="hf_..."
    ```

### تشغيل الوكيل

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

```bash
cd packages/mcp-client
pnpm agent
```

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

```bash
pnpm --filter @huggingface/mcp-client agent
```

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

### Configuration (متغيرات البيئة)

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

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

```bash
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