خادم Venice MCP | Venice API Docs

خادم Venice MCP هو خادم Model Context Protocol الرسمي لـ Venice. يكشف Venice API (الدردشة، الصور، الفيديو، الصوت، الموسيقى، embeddings، web augment، الشخصيات، crypto RPC، وتصديق TEE) إلى جانب عمليات الحساب (الفوترة ومفاتيح API) كـ 45 أداة يمكن لأي وكيل متوافق مع MCP استدعاؤها.

GitHub: veniceai/venice-mcp-server

منشور كـ @veniceai/mcp-server على npm. مرخص تحت MIT.

45 أداة

كل صيغ Venice بالإضافة إلى أدوات الفوترة ومفاتيح API وTEE

أي مضيف MCP

Claude Desktop و Cursor و ChatGPT و LM Studio و Continue والمزيد

مصادقة المحفظة (اختياري)

أحضر مفتاح API، أو ادفع لكل استدعاء بمحفظة موقعة بـ SIWE عبر x402

البدء السريع

احصل على مفتاح Venice API

أنشئ واحدًا من venice.ai/settings/api. انظر دليل مفتاح API للحصول على تعليمات خطوة بخطوة.

أضف Venice إلى تكوين مضيف MCP

ضع هذا في ملف تكوين مضيف MCP الخاص بك:

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "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 في التطبيق)

أعد تشغيل مضيف MCP

أصبح لدى وكيلك الآن أدوات الدردشة والصور والفيديو والموسيقى و TTS و ASR و 39 أداة Venice إضافية.

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

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

45 أداة تغطي كل صيغ Venice بالإضافة إلى عمليات الحساب، و3 موارد (venice://models, venice://styles, venice://voices)، و3 قوالب prompt (بحث غير خاضع للرقابة، كتابة إبداعية NSFW، مستكشف أنماط الصور). تعلن كل أداة عن تعليقات توضيحية صريحة readOnlyHint وdestructiveHint وidempotentHint وopenWorldHint، بحيث يمكن للمضيفين تشغيل عمليات البحث دون مطالبة المستخدم وطلب التأكيد قبل أي إجراء مدمّر، مثل تنظيف الوسائط أو ترحيل معاملة عملات مشفرة.

الدردشة و embeddings

الأداة	الوصف
`venice_chat`	إكمال دردشة متوافق مع OpenAI ضد كتالوج LLM الكامل لـ Venice، مع كتل النص/الصورة/الصوت/الفيديو/الملفات، والمخرجات المهيكلة، وأدوات الدوال، والتخزين المؤقت للمطالبات، وعناصر التحكم في الاستدلال. الاستدعاءات بنص عادي وبدون بث.
`venice_responses`	واجهة Responses API تجريبية (Beta) عديمة الحالة ومتوافقة مع OpenAI، مع إدخال النص/الصورة وعناصر التحكم في الاستدلال. لا تكشف هذه الأداة حقول استدعاء الأدوات، ولا تدعم نماذج E2EE.
`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`	تحرير ما يصل إلى 8 صور معًا بمطالبة واحدة (التركيب / التوسيع الخارجي).
`venice_image_upscale`	ترقية صورة بمقدار 2 إلى 4×، مع عنصر تحكم `creativity`.
`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`	التحقق من حالة مهمة فيديو في قائمة الانتظار (`POST /video/retrieve`).
`venice_video_complete`	وضع علامة على فيديو مكتمل كمُنزَّل وحذف وسائطه على جانب الخادم. يُبلغ عن الحذف فقط عندما تؤكده Venice.
`venice_video_quote`	الحصول على عرض سعر قبل الإضافة إلى قائمة الانتظار.

الصوت (TTS / ASR)

الأداة	الوصف
`venice_tts`	تحويل النص إلى كلام بأصوات مستنسخة ودرجة الحرارة وعلامات عاطفية. يُجمَّع البث في نتيجة صوتية واحدة كاملة.
`venice_asr`	نسخ صوت من عنوان URL، مع طوابع زمنية اختيارية على مستوى الكلمة/الحرف. تُقسَّم النصوص الطويلة إلى صفحات عبر مُعرِّف جلسة.
`venice_voice_clone`	عرض الأصوات الحية الخاصة بكل نموذج، أو استنساخ صوت من عنوان URL لعينة (يعيد مُعرِّفًا `vv_<id>` لاستخدامه مع `venice_tts`).
`venice_audio_quote`	الحصول على عرض سعر لتوليد الموسيقى.

الموسيقى

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

Web augment

الأداة	الوصف
`venice_web_search`	البحث على الويب باستخدام Brave (الافتراضي، بدون الاحتفاظ بالبيانات) أو Google (عبر وكيل Venice وبشكل مجهول الهوية).
`venice_web_scrape`	كشط عنوان URL واحد إلى markdown.
`venice_text_parser`	استخراج النص من PDF/DOCX/EPUB/PPTX/XLSX.

الكتالوج والشخصيات

الأداة	الوصف
`venice_list_models`	تصفح كتالوج النماذج الحي بجميع أنواعها، مع ملخصات موجزة وأسعار وعلامات القدرات.
`venice_model_details`	الحصول على الصف الكامل لنموذج محدد: قيود `model_spec` والقدرات والتسعير.
`venice_model_traits`	ربط أسماء السمات (`default`, `most_uncensored`, …) بمعرّفات النماذج الحالية.
`venice_model_compatibility_mapping`	ربط أسماء النماذج المتوافقة بمعرّفات نماذج Venice.
`venice_list_characters`	عرض شخصيات Venice العامة مع عوامل تصفية البحث والوسوم والنموذج والفرز. مفتاح API فقط.
`venice_get_character`	الحصول على شخصية عامة واحدة بواسطة slug. مفتاح API فقط.
`venice_character_reviews`	عرض المراجعات العامة لشخصية مع تقسيم إلى صفحات. مفتاح API فقط.

تصديق TEE

الأداة	الوصف
`venice_tee_attestation`	جلب أدلة التصديق على مستوى العتاد (Intel TDX quote، وأدلة NVIDIA الاختيارية، ومفتاح التوقيع) لنموذج نصي يدعم TEE، باستخدام nonce خاص بك بحجم 32 بايت.
`venice_tee_signature`	جلب حمولة توقيع الجيب الآمن (enclave) لمعرّف طلب دردشة TEE مكتمل.

تعيد أداتا TEE أدلة المزوّد فقط: فهما لا تتحققان منها، ولا تشفّران الدردشة. تحقق بنفسك من الـ nonce المُعاد، وحالة وضع التصحيح، وارتباط مفتاح التوقيع قبل الوثوق بنموذج TEE؛ انظر التحقق من تصديق TEE. يرفض هذا الخادم enable_e2ee.

العملات المشفرة

الأداة	الوصف
`venice_crypto_networks`	عرض معرّفات الشبكات (slugs) الحية المقبولة من وكيل RPC.
`venice_crypto_rpc`	توجيه طلب JSON-RPC واحد، أو دفعة تصل إلى 100 طلب، إلى Ethereum وBase وArbitrum وOptimism وPolygon وSolana وStarknet وzkSync وLinea وBSC وAvalanche وBlast والمزيد.

يجب إرسال عمليات بث المعاملات (eth_sendRawTransaction، eth_sendUserOperation، sendTransaction في Solana، وعمليات الكتابة في Starknet) كطلبات فردية مع idempotency_key، ويجب إعادة استخدام المفتاح نفسه عند إعادة المحاولة.

الفوترة (مفاتيح المسؤول)

الأداة	الوصف
`venice_billing_balance`	الرصيد المتاح الحالي بالدولار الأمريكي وDIEM والاعتمادات المضمّنة.
`venice_billing_usage_analytics`	تحليلات استخدام مجمّعة تجريبية (Beta) حسب التاريخ والنموذج ومفتاح API (فترة سابقة أو نطاق مخصص).
`venice_billing_usage_history`	استخدام تفصيلي مع تقسيم إلى صفحات بالمؤشر ومخرجات JSON أو CSV.

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

مفاتيح API

الأداة	الوصف
`venice_list_api_keys`	عرض بيانات تعريف المفاتيح النشطة، مع آخر ستة أحرف فقط. مفتاح المسؤول فقط.
`venice_get_api_key`	الحصول على بيانات تعريف مفتاح واحد واستخدامه وأرصدته وحدود معدله بواسطة معرّف المفتاح. مفتاح المسؤول فقط.
`venice_api_key_rate_limits`	الأرصدة الحالية وحالة الوصول والمستوى وتاريخ الانتهاء وحدود المعدل الخاصة بكل نموذج. مفتاح استدلال أو مسؤول.
`venice_api_key_rate_limit_logs`	آخر 50 حدثًا لتجاوز حد المعدل (تجريبي). مفتاح المسؤول فقط.

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

ذات صلة فقط إذا قمت بالمصادقة بمحفظة عبر x402 بدلًا من مفتاح 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`	`deepseek-v4-flash-0731`
`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 أدناه.

إذا تم تعيين كل من VENICE_API_KEY و VENICE_SIWX_TOKEN، يفوز مفتاح API في معظم الاستدعاءات؛ انظر تغطية أوضاع المصادقة لمعرفة الاستثناءات.

حدود حجم الاستجابة

تُخزَّن الوسائط المُولَّدة مؤقتًا وتُضمَّن في نتيجة MCP بترميز base64، لذا لكل صيغة حد أقصى بالبايت.

متغير البيئة	الافتراضي	ينطبق على
`VENICE_MAX_IMAGE_RESPONSE_BYTES`	`33554432` (32 MiB)	`venice_image_generate`, `venice_image_edit`, `venice_image_multi_edit`, `venice_image_upscale`, `venice_image_remove_bg`
`VENICE_MAX_VIDEO_RESPONSE_BYTES`	`26214400` (25 MiB)	`venice_video_status`
`VENICE_MAX_AUDIO_RESPONSE_BYTES`	`33554432` (32 MiB)	`venice_tts`, `venice_music_status`

تُتجاهل نتيجة الصورة أو TTS التي تتجاوز الحجم مع ظهور خطأ. أما نتيجة الفيديو أو الموسيقى التي تتجاوز الحجم فتبقى في قائمة الانتظار، لذا يمكنك استدعاء أداة الحالة مرة أخرى بمعرّف قائمة الانتظار نفسه بعد رفع الحد.

خادم HTTP

ذو صلة فقط في نشر Streamable HTTP.

متغير البيئة	الافتراضي	ملاحظات
`PORT`	`3333`	منفذ مستمع HTTP.
`VENICE_MCP_HOST`	`127.0.0.1`	عنوان الربط. اضبطه على `0.0.0.0` للإتاحة عبر الشبكة المحلية أو الحاوية.
`VENICE_MCP_AUTH_TOKEN`	(لا شيء)	رمز Bearer لـ `/mcp`. مطلوب عند الربط خارج loopback، وفي هذه الحالة يجب ألا يقل عن 16 حرفًا. بمجرد تعيينه، يُفرض على loopback أيضًا.
`VENICE_MCP_ALLOW_UNAUTHENTICATED_HTTP`	`0`	منفذ هروب لإتاحة HTTP دون مصادقة. استخدمه فقط خلف وكيل موثوق يطبّق المصادقة.
`VENICE_MCP_MAX_SESSIONS`	`100`	الحد الأقصى لجلسات Streamable HTTP النشطة.
`VENICE_MCP_SESSION_TTL_MS`	`1800000`	مدة بقاء الجلسة الخاملة قبل تنظيفها.

سلوك توليد الوسائط

يمكن أن تكون الوسائط المكتملة بايتات أو عنوان URL. تعيد مهام الفيديو والموسيقى موارد MP4/صوت مُضمَّنة، أو JSON يحتوي على download_url يُعاد كرابط مورد. نزّل هذا الرابط أولًا، ثم استدعِ venice_video_complete أو venice_music_complete؛ لا يُطبَّق تنظيف الوسائط أبدًا على نتيجة download_url لأن الرابط يتوقف عن العمل بمجرد حذف الملف.
بعض النماذج تعيد عنوان URL فقط وقت الإضافة إلى قائمة الانتظار. بالنسبة لنماذج VPS وGrok Imagine Private، احتفظ بـ download_url الذي تعيده venice_video_generate ومرّره إلى venice_video_status؛ فعملية الاسترجاع بحالة COMPLETED دون عنوان URL مضمّن تعطي رابطًا صالحًا للاستخدام.
يُبلَغ عن تحسين المطالبة. عند تطبيق enhance_prompt، تتضمن نتائج توليد الصور وتحريرها والتحرير المتعدد المطالبة المفكوكة الترميز من URL التي أعادتها Venice.
تُحتسب تكلفة تقسيم صفحات ASR مرة واحدة. النصوص التي تتجاوز 8,000 حرف، أو التي تحتوي على طوابع زمنية أكثر مما تتسع له صفحة واحدة (200 لكل مصفوفة افتراضيًا، وحتى 500 مع timestamp_limit)، تعيد result_handle مع الصفحة الأولى. اطلب الصفحات اللاحقة باستخدام هذا المُعرِّف. تبقى المُعرِّفات في الذاكرة لكل جلسة MCP لمدة 10 دقائق، ويُحتفظ فقط بأحدث 16 منها.
موافقة Seedance ليست تجاوزًا للسياسة. قد ترفض نماذج Seedance العامة الحالية الوسائط التي تحتوي على أشخاص يمكن التعرف عليهم رفضًا قاطعًا. عند إعادة استجابة needs_consent، فإن علامات consents.seedance الثلاث هي إقرارات قانونية: اضبطها على true فقط بعد أن يؤكد المستخدم كل بيان صراحةً.

وضع محفظة x402

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

{
  "mcpServers": {
    "venice": {
      "command": "npx",
      "args": ["-y", "@veniceai/[email protected]"],
      "env": { "VENICE_SIWX_TOKEN": "<base64 Sign-In-With-X payload>" }
    }
  }
}

يقوم خادم MCP بإعادة توجيه VENICE_SIWX_TOKEN في ترويسة 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 `SIGN-IN-WITH-X: <SIWX>`؛ تخصم Venice من رصيدك المدفوع مسبقًا.

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

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

لا تقبل Venice ترويسات الدفع على مسارات الاستدلال، لذا لا يرسل هذا الخادم أيًا منها أبدًا. تخص PAYMENT-SIGNATURE المسار /x402/top-up فقط، وتكتشف أداة مساعدة الشحن المتطلبات دون إرسال أي دفعة.

تغطية أوضاع المصادقة

تقبل بعض نقاط النهاية وضع مصادقة واحدًا فقط:

الأداة	مفتاح API	x402
الاستدلال، الوسائط، web augment، crypto RPC، الدردشة مع الشخصيات	✓	✓
`venice_list_characters`, `venice_get_character`, `venice_character_reviews`	✓	✗
`venice_billing_*`, `venice_list_api_keys`, `venice_get_api_key`, `venice_api_key_rate_limit_logs`	✓ (مسؤول)	✗
`venice_api_key_rate_limits`	✓ (أي مفتاح)	✗
`venice_x402_balance`, `venice_x402_transactions`	✗	✓
`venice_x402_top_up_info`	✓	✓

عند تعيين بيانات الاعتماد كلتيهما، يُستخدم مفتاح API لكل استدعاء يتطلب مصادقة باستثناء venice_x402_balance وvenice_x402_transactions، اللتين ترسلان دائمًا رمز المحفظة.

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

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

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> وينبغي أن ينشئوا جلسات جديدة دون ترويسة mcp-session-id، ثم يعيدوا استخدام معرّف الجلسة الصادر عن الخادم.

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

الموارد

GitHub

شفرة المصدر والمشكلات والإصدارات

npm

@veniceai/mcp-server

مهارات Venice

مهارات مرافقة تعلّم الوكلاء كيفية استخدام هذه الأدوات

مواصفات MCP

تعلم المزيد عن Model Context Protocol

GitHub: veniceai/venice-mcp-server

45 أداة

أي مضيف MCP

مصادقة المحفظة (اختياري)

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

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

​الدردشة و embeddings

​الصور

​الفيديو

​الصوت (TTS / ASR)

​الموسيقى

​Web augment

​الكتالوج والشخصيات

​تصديق TEE

​العملات المشفرة

​الفوترة (مفاتيح المسؤول)

​مفاتيح API

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

​التكوين

​النماذج والطلبات

​حدود حجم الاستجابة

​خادم HTTP

​سلوك توليد الوسائط

​وضع محفظة x402

​تغطية أوضاع المصادقة

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

​الموارد

GitHub

npm

مهارات Venice

مواصفات MCP

البدء السريع

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

الدردشة و embeddings

الصور

الفيديو

الصوت (TTS / ASR)

الموسيقى

Web augment

الكتالوج والشخصيات

تصديق TEE

العملات المشفرة

الفوترة (مفاتيح المسؤول)

مفاتيح API

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

التكوين

النماذج والطلبات

حدود حجم الاستجابة

خادم HTTP

سلوك توليد الوسائط

وضع محفظة x402

تغطية أوضاع المصادقة

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

الموارد