/ الدليل / الملعب / MCP-Bridge
← كل الخوادم ↗ GitHub
● مجتمع SecretiveShell ⚡ فوري

MCP-Bridge

بواسطة SecretiveShell · SecretiveShell/MCP-Bridge

استخدم أدوات MCP من أي عميل متوافق مع OpenAI — LibreChat أو Open WebUI أو تطبيقك المخصص — دون دعم MCP أصلي. برنامج وسيط يجسر الفجوة بينهما.

يقع MCP-Bridge بين عميل OpenAI المتوافق والخادم الخلفي للاستدلال. يعرّض أدوات خادم MCP كأدوات استدعاء دوال من نمط OpenAI، ويوجه الاستدعاءات، ويعيد النتائج لإكمال الحلقة. مفيد عندما لا تدعم واجهة الدردشة المفضلة لديك MCP لكنها تدعم OpenAI.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

bridge.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "bridge": {
      "command": "uvx",
      "args": [
        "MCP-Bridge"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "bridge": {
      "command": "uvx",
      "args": [
        "MCP-Bridge"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "bridge": {
      "command": "uvx",
      "args": [
        "MCP-Bridge"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "bridge": {
      "command": "uvx",
      "args": [
        "MCP-Bridge"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "bridge",
      "command": "uvx",
      "args": [
        "MCP-Bridge"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "bridge": {
      "command": {
        "path": "uvx",
        "args": [
          "MCP-Bridge"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add bridge -- uvx MCP-Bridge

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: MCP-Bridge

إضافة أدوات MCP إلى LibreChat / أي واجهة دردشة متوافقة مع OpenAI

👤 الأشخاص الذين يستضيفون واجهات دردشة مفتوحة المصدر بأنفسهم ⏱ ~30 min intermediate

متى تستخدمه: تقوم بتشغيل LibreChat أو Big-AGI أو تطبيق مخصص يستدعي /v1/chat/completions ويريد استخدام الأدوات، لكنه لا يتحدث MCP.

المتطلبات الأساسية
  • خادم خلفي للاستدلال متوافق مع OpenAI — OpenAI أو Anthropic-via-proxy أو vLLM أو Ollama وغيرها
  • خادم MCP واحد على الأقل تريد تعريضه — filesystem أو fetch أو postgres — أي شيء لديك
الخطوات
  1. كتابة config.json
    اكتب لي ملف config.json خاص بـ MCP-Bridge يوكيل OpenAI ويعرّض MCP نظام الملفات (مع الجذر في /data) و MCP fetch.✓ تم النسخ
    → إعدادات صحيحة مع أقسام inference_server و mcp_servers
  2. التشغيل عبر Docker
    أعطني أمر docker run لتشغيل MCP-Bridge باستخدام هذا الإعداد على المنفذ 8000.✓ تم النسخ
    → أمر docker يعمل مع نقاط تثبيت المجلدات
  3. توجيه واجهة الدردشة نحو الجسر
    أريني عنوان URL الأساسي للـ API الذي يجب ضبطه في LibreChat لاستخدام الجسر بدلاً من OpenAI مباشرة.✓ تم النسخ
    → إعداد يشير إلى http://localhost:8000/v1

النتيجة: يمكن لحوارات LibreChat الآن استدعاء أدوات نظام الملفات و fetch بشكل شفاف.

المزالق
  • ليس جميع عملاء OpenAI المتوافقين يدعمون استدعاءات الأدوات — تحقق من أن واجهتك تدعم functions في الردود قبل الربط؛ تحقق من وثائقها لدعم 'استدعاء الأدوات'
  • لم يتم تنفيذ الردود المتدفقة بعد — عطّل البث في العميل؛ استخدم نقاط نهاية غير متدفقة
اجمعها مع: filesystem · fetch

امنح إطار عمل الوكيل الخاص بك Python/JS وصولاً إلى أدوات MCP

👤 المطورون الذين يبنون وكلاء مخصصين على OpenAI SDK ⏱ ~25 min intermediate

متى تستخدمه: تبني باستخدام OpenAI SDK الخام (أو عميل OpenAI الخاص بـ LangChain) وتريد توصيل نظام البيئة MCP دون إعادة كتابة الوكيل.

الخطوات
  1. بدء MCP-Bridge محلياً
    شغّل MCP-Bridge مع تعيين upstream إلى OpenAI وخوادم MCP هذه: [list].✓ تم النسخ
    → الجسر يستمع على :8000
  2. توجيه OpenAI client base_url نحو الجسر
    أريني تهيئة Python SDK: client = OpenAI(base_url='http://localhost:8000/v1', api_key=...). ثم استدعِ اكتمال الدردشة.✓ تم النسخ
    → مقتطف الرمز الذي يعمل بدون تغيير

النتيجة: وصول مباشر للأدوات في كود الوكيل الموجود لديك.

المزالق
  • الجسر نقطة فشل واحدة — للإنتاج، شغّل مع supervisord/systemd ونقطة نهاية healthcheck

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

bridge + filesystem + fetch

بديل ChatGPT مستضاف ذاتياً برخص مع استخدام أدوات حقيقية

عرّض نظام الملفات (مع الجذر في ~/Notes) و fetch عبر MCP-Bridge، ثم استخدم LibreChat للتصفح + التلخيص.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
POST /v1/chat/completions OpenAI-compatible messages + tools omitted (auto-injected) نقطة الدخول الرئيسية — جاهزة للاستخدام بدلاً من OpenAI 1 LLM call + N tool calls
GET /tools اكتشف ما هو متاح free
SSE /bridge أرفق عميل MCP خارجي بالجسر عبر SSE free

التكلفة والحدود

تكلفة التشغيل

حصة API
بدون رسوم إضافية — مهما كانت الرسوم التي يفرضها مزود الاستدلال الخاص بك
الرموز لكل استدعاء
يضيف الجسر ~100-500 رمز من تعريفات الأدوات لكل طلب
التكلفة المالية
مجاني (MIT). تدفع مقابل LLM الخاص بك + أينما تستضيفه.
نصيحة
أرفق فقط خوادم MCP التي تحتاجها — كل أداة مرفقة تضخم المطالبة النظامية.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: مفتاح API المنبع + بيانات اعتماد خادم MCP في config.json؛ قفل صلاحيات الملف
نقل البيانات الخارجي: تذهب الطلبات إلى المنبع المكون لديك (مثل OpenAI) + أي خوادم MCP أخرى
لا تمنح أبدًا: لا تعرّض الجسر للإنترنت دون تفعيل مصادقة bearer

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Client says 'tool_use not supported'

نموذج المنبع أو واجهة العميل لا تدعم استدعاء الدوال. استخدم نموذجاً يدعمها (gpt-4o أو claude أو llama 3.1+).

MCP server connection refused

تحقق من أن الأمر في config.json يعمل فعلاً. يشغل الجسر كعملية فرعية؛ اختبر يدوياً: npx -y the-mcp.

401 from bridge when auth enabled

اضبط رأس Authorization: Bearer <key>؛ يجب أن يكون المفتاح في الإعداد تحت security.auth.keys.

البدائل

MCP-Bridge مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Open WebUI native MCPإذا كنت تستخدم Open WebUI 0.6.31+ على وجه التحديدمدمج — لا حاجة لجسر، لكن Open WebUI فقط
LiteLLM with custom callbacksإذا كنت تريد توجيه متعدد المزودين + حقن الأدواتأكثر تعقيداً؛ LiteLLM لا يتحدث MCP بشكل أصلي أيضاً
mcpoإذا كنت تريد تعريض أدوات MCP كـ OpenAPI عادي للعملاء غير LLM أيضاًشكل مختلف — OpenAPI-first بدلاً من chat-completions-first

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills