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

# خادم Venice MCP

> يكشف خادم Venice Model Context Protocol الرسمي 31 أداة Venice للدردشة والصور والفيديو والصوت والموسيقى والشخصيات في أي مضيف MCP.

[خادم Venice MCP](https://github.com/veniceai/venice-mcp-server) هو خادم [Model Context Protocol](https://modelcontextprotocol.io/) الرسمي لـ Venice. يكشف Venice API بالكامل (الدردشة، الصور، الفيديو، الصوت، الموسيقى، embeddings، web augment، والشخصيات) كـ **31 أداة** يمكن لأي وكيل متوافق مع MCP استدعاؤها.

<Card title="GitHub: veniceai/venice-mcp-server" icon="github" href="https://github.com/veniceai/venice-mcp-server">
  منشور كـ [`@veniceai/mcp-server`](https://www.npmjs.com/package/@veniceai/mcp-server) على npm. مرخص تحت MIT.
</Card>

<CardGroup cols={3}>
  <Card title="31 أداة" icon="toolbox">
    كل صيغة Venice في كتلة تكوين واحدة
  </Card>

  <Card title="أي مضيف MCP" icon="plug">
    Claude Desktop و Cursor و ChatGPT و LM Studio و Continue والمزيد
  </Card>

  <Card title="مصادقة المحفظة (اختياري)" icon="wallet">
    أحضر مفتاح API، أو ادفع لكل استدعاء بمحفظة موقعة بـ SIWE عبر x402
  </Card>
</CardGroup>

## البدء السريع

<Steps>
  <Step title="احصل على مفتاح Venice API">
    أنشئ واحدًا من [venice.ai/settings/api](https://venice.ai/settings/api). انظر [دليل مفتاح API](/guides/getting-started/generating-api-key) للحصول على تعليمات خطوة بخطوة.
  </Step>

  <Step title="أضف Venice إلى تكوين مضيف MCP">
    ضع هذا في ملف تكوين مضيف MCP الخاص بك:

    ```json theme={"system"}
    {
      "mcpServers": {
        "venice": {
          "command": "npx",
          "args": ["-y", "@veniceai/mcp-server@0.2.0"],
          "env": { "VENICE_API_KEY": "<your-venice-api-key>" }
        }
      }
    }
    ```

    مسارات التكوين الشائعة:

    | المضيف                   | المسار                                                            |
    | ------------------------ | ----------------------------------------------------------------- |
    | Claude Desktop (macOS)   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
    | Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json`                     |
    | Cursor                   | `~/.cursor/mcp.json`                                              |
    | LM Studio                | `mcp.json` (من إعدادات MCP في التطبيق)                            |
  </Step>

  <Step title="أعد تشغيل مضيف MCP">
    أصبح لدى وكيلك الآن أدوات الدردشة والصور والفيديو والموسيقى و TTS و ASR و 25 أداة Venice إضافية.
  </Step>
</Steps>

<Note>
  معظم مضيفي MCP يمررون فقط متغيرات البيئة المُدرجة **بشكل صريح** في كتلة `env`. لا تُورَّث متغيرات env على مستوى النظام. إذا رأيت أخطاء 402 مع مفتاح API مضبوط، تحقق مرتين من أن `VENICE_API_KEY` داخل `env` في التكوين الخاص بك.
</Note>

## ما الذي تحصل عليه

**31 أداة** تغطي كل صيغ Venice، و**3 موارد** (`venice://models`, `venice://styles`, `venice://voices`)، و**3 قوالب prompt**.

### الدردشة و embeddings

| الأداة                       | الوصف                                                                      |
| ---------------------------- | -------------------------------------------------------------------------- |
| `venice_chat`                | إكمال دردشة متوافق مع OpenAI ضد كتالوج LLM الكامل لـ Venice.               |
| `venice_responses`           | واجهة Responses API متوافقة مع OpenAI مع دعم أدوات أحادي أو متعدد الأدوار. |
| `venice_embeddings`          | حساب embeddings لإدخال نصي.                                                |
| `venice_chat_with_character` | دردش مع شخصية Venice بواسطة slug.                                          |

### الصور

| الأداة                    | الوصف                                                                                          |
| ------------------------- | ---------------------------------------------------------------------------------------------- |
| `venice_image_generate`   | توليد صورة (Flux 2، Lustify SDXL، Anime/WAI، Qwen Image، GPT Image، Nano Banana Pro، والمزيد). |
| `venice_image_edit`       | تحرير صورة بمطالبة.                                                                            |
| `venice_image_multi_edit` | تحرير صور متعددة معًا بمطالبة واحدة.                                                           |
| `venice_image_upscale`    | ترقية صورة حتى 4×.                                                                             |
| `venice_image_remove_bg`  | إزالة خلفية الصورة.                                                                            |
| `venice_image_styles`     | عرض إعدادات أنماط الصور المسبقة.                                                               |

### الفيديو

| الأداة                        | الوصف                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `venice_video_generate`       | إضافة توليد فيديو إلى قائمة الانتظار (Sora 2، Veo 3.1، Kling، Wan، LTX 2، Seedance، Runway Gen-4، والمزيد). |
| `venice_video_status`         | التحقق من حالة مهمة فيديو في قائمة الانتظار.                                                                |
| `venice_video_complete`       | وضع علامة على فيديو مكتمل كمُنزَّل؛ يحذف الوسائط على جانب الخادم.                                           |
| `venice_video_transcriptions` | نسخ نصي لعنوان URL لفيديو YouTube.                                                                          |
| `venice_video_quote`          | الحصول على عرض سعر قبل وضع في قائمة الانتظار.                                                               |

### الصوت (TTS / ASR)

| الأداة               | الوصف                                              |
| -------------------- | -------------------------------------------------- |
| `venice_tts`         | تحويل النص إلى كلام بأصوات مستنسخة وعلامات عاطفية. |
| `venice_asr`         | نسخ صوت من عنوان URL.                              |
| `venice_voice_clone` | عرض الأصوات المدمجة أو استنساخ صوت من عينة.        |
| `venice_audio_quote` | الحصول على عرض سعر لتوليد الموسيقى.                |

### الموسيقى

| الأداة                  | الوصف                                                                                                                                                                  |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `venice_music_generate` | إضافة توليد موسيقى إلى قائمة الانتظار (`ace-step-15`, `elevenlabs-music`, `minimax-music-v2/v25/v26`, `stable-audio-25`, `mmaudio-v2`, `elevenlabs-sound-effects-v2`). |
| `venice_music_status`   | التحقق من حالة مهمة موسيقى في قائمة الانتظار.                                                                                                                          |
| `venice_music_complete` | وضع علامة على مهمة موسيقى مكتملة كمُنزَّلة.                                                                                                                            |

### Web augment والكتالوج والعملات المشفرة

| الأداة                   | الوصف                                                                             |
| ------------------------ | --------------------------------------------------------------------------------- |
| `venice_web_search`      | البحث على الويب (مدعوم بـ Firecrawl).                                             |
| `venice_web_scrape`      | كشط عنوان URL واحد إلى markdown.                                                  |
| `venice_text_parser`     | استخراج النص من PDF/DOCX/EPUB/PPTX/XLSX.                                          |
| `venice_list_models`     | عرض كتالوج النماذج الحي مع الأسعار.                                               |
| `venice_list_characters` | عرض شخصيات Venice العامة.                                                         |
| `venice_crypto_rpc`      | توجيه استدعاءات JSON-RPC إلى Base أو Ethereum أو Polygon أو Arbitrum أو Optimism. |

### مساعدات محفظة x402

ذات صلة فقط إذا قمت بالمصادقة بمحفظة عبر [x402](/guides/integrations/x402-venice-api) بدلًا من مفتاح API.

| الأداة                     | الوصف                                                              |
| -------------------------- | ------------------------------------------------------------------ |
| `venice_x402_balance`      | التحقق من رصيد x402 المدفوع مسبقًا لعنوان محفظة EVM أو Solana.     |
| `venice_x402_top_up_info`  | جلب متطلبات الشحن (الشبكة، رمز USDC، المستلم، الحد الأدنى للمبلغ). |
| `venice_x402_transactions` | عرض المعاملات الأخيرة لشحن وخصم x402 لعنوان محفظة EVM أو Solana.   |

## التكوين

يتم تكوين الخادم بالكامل عبر متغيرات البيئة.

| متغير البيئة                 | الافتراضي                 | ملاحظات                                                          |
| ---------------------------- | ------------------------- | ---------------------------------------------------------------- |
| `VENICE_API_KEY`             | *(لا شيء)*                | مفتاح Venice API الخاص بك. الإعداد الأبسط.                       |
| `VENICE_DEFAULT_CHAT_MODEL`  | `venice-uncensored`       |                                                                  |
| `VENICE_DEFAULT_IMAGE_MODEL` | `flux-2-pro`              |                                                                  |
| `VENICE_DEFAULT_TTS_MODEL`   | `tts-kokoro`              |                                                                  |
| `VENICE_DEFAULT_ASR_MODEL`   | `openai/whisper-large-v3` |                                                                  |
| `VENICE_DISABLE_NSFW`        | `0`                       | اضبط على `1` لإزالة ملاحظات قدرة NSFW من أوصاف الأدوات.          |
| `VENICE_HTTP_TIMEOUT_MS`     | `60000`                   |                                                                  |
| `VENICE_SIWX_TOKEN`          | *(لا شيء)*                | رمز مصادقة وضع محفظة x402. انظر [x402 أدناه](#x402-wallet-mode). |

إذا تم تعيين كل من `VENICE_API_KEY` و `VENICE_SIWX_TOKEN`، يفوز مفتاح API.

## وضع محفظة x402

تدعم Venice المصادقة برمز [Sign-In-With-X wallet](/guides/integrations/x402-venice-api) المدعوم برصيد USDC المدفوع مسبقًا على Base أو Solana، بالإضافة إلى التدفق العادي لمفتاح API. لا يلزم بريد إلكتروني أو هاتف أو KYC: محفظتك هي الهوية الوحيدة.

```json theme={"system"}
{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/mcp-server@0.2.0"],
      "env": { "VENICE_SIWX_TOKEN": "<base64 Sign-In-With-X payload>" }
    }
  }
}
```

يقوم خادم MCP بإعادة توجيه `VENICE_SIWX_TOKEN` كترويسة `X-Sign-In-With-X` في كل استدعاء لـ Venice API. لا يرى الخادم أبدًا مفتاحك الخاص. توقيع المحفظة وتفويض شحن USDC يحدث في محفظتك الخاصة.

| التدفق                 | ما الذي يحدث                                                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **إعداد لمرة واحدة**   | وقّع رسالة Sign-In-With-X في محفظتك → ينتج رمز SIWX (base64 JSON).                                                                                |
| **الشحن**              | `POST /api/v1/x402/top-up` يعيد 402 + متطلبات الدفع. وقّع دفعة USDC لأحد خيارات Base أو Solana المعادة، أعد الإرسال، وسيقوم Venice بإضافة الرصيد. |
| **كل استدعاء استدلال** | يرسل خادم MCP `X-Sign-In-With-X: <SIWX>`؛ يخصم Venice من رصيدك المدفوع مسبقًا.                                                                    |

الحد الأدنى للشحن **5 دولارات أمريكية**. الحد الأدنى للرصيد لاستدعاء الاستدلال **0.10 دولار**. بمجرد الشحن، تكون الاستدعاءات أقل من 100 مللي ثانية لأن التسوية تحدث خارج السلسلة في حساب ائتمان سريع.

<Tip>
  المحافظ المرتبطة بحساب Venice مع DIEM المُربط تستهلك من رصيد الـ staking بدلًا من اعتمادات USDC، لذا لا يلزم شحن.
</Tip>

## الاستضافة الذاتية (Streamable HTTP)

لعمليات النشر الجماعية أو لمساحات العمل، شغّل خادم MCP عبر HTTP بدلًا من stdio:

```bash theme={"system"}
docker run -p 3333:3333 \
  -e VENICE_API_KEY=<your-venice-api-key> \
  -e VENICE_MCP_AUTH_TOKEN=<choose-a-long-random-token> \
  ghcr.io/veniceai/venice-mcp-server:latest
```

الخادم الآن متاح على `http://localhost:3333/mcp`. يجب أن يرسل عملاء HTTP `Authorization: Bearer <VENICE_MCP_AUTH_TOKEN>`.

<Warning>
  `/mcp` هي نقطة نهاية لتنفيذ أدوات مدعومة بالاعتمادات: يمكن للمتصلين إنفاق مفتاح Venice API المُكوَّن أو رصيد x402. عندما يرتبط وضع HTTP خارج loopback، يفشل بدء التشغيل ما لم يتم تعيين `VENICE_MCP_AUTH_TOKEN`. للإنتاج، ثبّت إصدار حزمة npm بشكل صريح بدلًا من الاعتماد على `latest`.
</Warning>

## الموارد

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/venice-mcp-server">
    شفرة المصدر والمشكلات والإصدارات
  </Card>

  <Card title="npm" icon="npm" href="https://www.npmjs.com/package/@veniceai/mcp-server">
    `@veniceai/mcp-server`
  </Card>

  <Card title="مهارات Venice" icon="book" href="/guides/integrations/venice-skills">
    مهارات مرافقة تعلّم الوكلاء كيفية استخدام هذه الأدوات
  </Card>

  <Card title="مواصفات MCP" icon="arrow-up-right-from-square" href="https://modelcontextprotocol.io/">
    تعلم المزيد عن Model Context Protocol
  </Card>
</CardGroup>