دليل إعداد خادم MCP

نظرة عامة

unorouter-mcp حزمة npm تعمل كخادم MCP عبر stdio ومنشورة في سجل MCP الرسمي باسم com.unorouter/mcp. توفر ثلاث أدوات: search_models يفلتر الكتالوج المباشر ويدعم خيار free_only، وget_pricing يعيد أسعار القائمة بالدولار الأمريكي لكل مليون توكن، وchat يرسل موجّهًا إلى أي نموذج. الشيفرة المصدرية على github.com/0-don/unorouter-mcp.

إعداد سريع

أدخل هذه القيم في العميل. يُملأ مفتاحك تلقائيًا عند تسجيل الدخول.

عنوان URL الأساسي: https://api.unorouter.com/v1
مفتاح API: YOUR_API_KEY

التوافق

الإعداد خطوة بخطوة

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

   أنشئ مفتاحًا من unorouter.com/token. يقرأ الخادم المفتاح من متغير البيئة UNOROUTER_API_KEY. أما UNOROUTER_BASE_URL فهو تجاوز اختياري لنقطة النهاية.

   bash

   UNOROUTER_API_KEY=YOUR_API_KEY
   UNOROUTER_BASE_URL=https://api.unorouter.com/v1

   سجّل الدخول لتعبئة مفتاح API تلقائياً

2. 2
   أضف الخادم إلى Claude Desktop

   أضف هذه الكتلة إلى ملف إعدادات Claude Desktop. يجلب npx حزمة unorouter-mcp عند أول تشغيل، فلا حاجة لتثبيت مسبق.

   json

   {
     "mcpServers": {
       "unorouter": {
         "command": "npx",
         "args": ["-y", "unorouter-mcp"],
         "env": { "UNOROUTER_API_KEY": "YOUR_API_KEY" }
       }
     }
   }

   سجّل الدخول لتعبئة مفتاح API تلقائياً

3. 3
   أو سجّله في Claude Code

   أمر واحد يسجل الخادم مع مفتاحك.

   bash

   claude mcp add unorouter -e UNOROUTER_API_KEY=YOUR_API_KEY -- npx -y unorouter-mcp

   سجّل الدخول لتعبئة مفتاح API تلقائياً

4. 4
   استخدم الأدوات

   اطلب من عميلك العثور على نموذج أو مقارنة الأسعار أو إرسال موجّه إلى نموذج. سيستدعي search_models وget_pricing وchat عند الحاجة. يعمل أي عميل MCP يتعامل عبر stdio.

   text

   search_models  filter the live catalog (free_only option)
   get_pricing    USD list prices per 1M tokens
   chat           send a prompt to any model

   سجّل الدخول لتعبئة مفتاح API تلقائياً

النماذج الموصى بها

نماذج مجانية تعمل جيدًا هنا. الصق أي معرّف نموذج في العميل.

ملاحظات مهمة

• !النماذج ذات اللاحقة :free مجانية تمامًا. توقع حدًا يقارب طلبًا واحدًا في الدقيقة لكل نموذج مجاني.
• !المتغير UNOROUTER_API_KEY إلزامي. لا تضبط UNOROUTER_BASE_URL إلا إذا وجهت الخادم إلى نقطة نهاية أخرى.
• !عملاء MCP الداعمون للسجل يمكنهم تثبيت الخادم باسمه في السجل com.unorouter/mcp بدلًا من أمر npx.