> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mibyanai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# باكجات مبيان الرسمية

> اختر الباكج المناسبة واستخدم مبيان في تطبيقك

توفر مبيان باكجات رسمية لـ JavaScript وReact وPython وMCP.

## ما هي الباكجات؟

الباكج هي كود جاهز تثبّته في مشروعك ليستخدم API مبيان بطريقة سهلة. بدلاً من كتابة طلبات API والبث المباشر ومعالجة الأخطاء من الصفر، تستخدم الباكج الرسمية وتبدأ بعدة أسطر فقط.

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

## أي باكج أختار؟

| الباكج          | الاستخدام                             | المستودع    |
| --------------- | ------------------------------------- | ----------- |
| `@mibyan/sdk`   | أغلب تطبيقات JavaScript وTypeScript   | npm         |
| `@mibyan/react` | واجهات React والمحادثات المتدفقة      | npm         |
| `@mibyan/mcp`   | أدوات MCP مثل Cursor وClaude          | npm         |
| `@mibyan/core`  | بناء تكامل أو مكتبة TypeScript متقدمة | npm         |
| `mibyan-sdk`    | تطبيقات Python                        | PyPI قريباً |

**لست متأكداً؟** ابدأ دائماً بـ `@mibyan/sdk`.

## JavaScript وTypeScript

هذه هي البداية المناسبة لمعظم المطورين.

```bash theme={null}
npm install @mibyan/sdk
```

```ts theme={null}
import Mibyan from "@mibyan/sdk";

const client = new Mibyan({ apiKey: process.env.MIBYAN_API_KEY! });
const result = await client.chat.completions.create({
  model: "mibyan-4.1",
  messages: [{ role: "user", content: "مرحبا" }],
});

console.log(result.choices[0]?.message.content);
```

للبث المباشر، أضف `stream: true` ثم استخدم `for await` على النتيجة.

## React

استخدم `@mibyan/react` عندما تبني واجهة محادثة في React وتريد حالة جاهزة للرسائل، وحقل الإدخال، والبث، والأخطاء.

```bash theme={null}
npm install @mibyan/react
```

راجع README الخاص بالباكج لمثال `useMibyanChat`. احتفظ بمفتاح API في السيرفر ولا تضعه داخل كود المتصفح.

## Python

باكج Python جاهزة في المشروع، وسيتم نشرها على PyPI قريباً. حالياً ثبّتها محلياً:

```bash theme={null}
python3 -m pip install ./packages/python
```

## MCP

```bash theme={null}
MIBYAN_API_KEY=your-key npx @mibyan/mcp
```

يعرّض السيرفر أداة `mibyan_chat` عبر MCP stdio. راجع [المصادقة](/ar/api-reference/authentication) لإدارة المفاتيح.

## كيف تسير العملية؟

1. أنشئ API key من منصة مبيان.
2. ثبّت الباكج المناسبة لمشروعك.
3. مرّر المفتاح إلى الباكج واستدعِ `mibyan-4.1`.
4. استخدم النص أو البث المباشر الذي يرجع لك في تطبيقك.