خادم Venice MCP

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

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

GitHub: veniceai/venice-mcp-server

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

31 أداة

كل صيغة Venice في كتلة تكوين واحدة

أي مضيف MCP

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

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

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

​

البدء السريع

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

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

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

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

   {
     "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 في التطبيق)

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

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

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

​

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

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 بدلًا من مفتاح 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 أدناه.

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

​

وضع محفظة x402

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

{
  "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 مللي ثانية لأن التسوية تحدث خارج السلسلة في حساب ائتمان سريع.

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

​

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

​

الموارد

GitHub

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

npm

@veniceai/mcp-server

مهارات Venice

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

مواصفات MCP

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