الانتقال إلى المحتوى الرئيسي
خادم 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/[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 Studiomcp.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_MODELvenice-uncensored
VENICE_DEFAULT_IMAGE_MODELflux-2-pro
VENICE_DEFAULT_TTS_MODELtts-kokoro
VENICE_DEFAULT_ASR_MODELopenai/whisper-large-v3
VENICE_DISABLE_NSFW0اضبط على 1 لإزالة ملاحظات قدرة NSFW من أوصاف الأدوات.
VENICE_HTTP_TIMEOUT_MS60000
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/[email protected]"],
      "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