/ الدليل / الملعب / mcphub.nvim
● مجتمع ravitemer ⚡ فوري

mcphub.nvim

بواسطة ravitemer · ravitemer/mcphub.nvim

إضافة Neovim تحول محررك إلى عميل MCP من الدرجة الأولى — تثبيت من المتجر، تكامل Avante/CodeCompanion، مصادقة OAuth PKCE.

تدمج ravitemer/mcphub.nvim خوادم MCP في سير عمل Neovim. اكتشف وثبّت عبر متجر موثوق، دردش عبر Avante/CodeCompanion/CopilotChat، أدِر OAuth، وأعد تحميل خوادم التطوير ديناميكياً. تدعم stdio و SSE و Streamable HTTP.

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

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

عرض مباشر

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

mcphub-nvim.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcphub-nvim",
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "mcphub-nvim": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/ravitemer/mcphub.nvim"
        ]
      }
    }
  }
}

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

claude mcp add mcphub-nvim -- TODO 'See README: https://github.com/ravitemer/mcphub.nvim'

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

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

استخدامات عملية: mcphub.nvim

كيفية استخدام خوادم MCP من Neovim عبر Avante أو CodeCompanion

👤 مطورو Neovim ⏱ ~20 min intermediate

متى تستخدمه: تعيش في Neovim ولا تريد التبديل إلى VS Code للوصول إلى MCP.

المتطلبات الأساسية
  • Neovim 0.10+ — brew install neovim
  • تثبيت Avante.nvim أو CodeCompanion.nvim — عبر مدير الإضافات الخاص بك (lazy.nvim/packer)
  • mcphub.nvim + تبعية Node الخاصة به — انظر إلى ravitemer.github.io/mcphub.nvim للحصول على مقطع التثبيت
الخطوات
  1. التثبيت عبر مدير الإضافات
    أضف ravitemer/mcphub.nvim إلى إعدادات lazy.nvim الخاصة بك مع opts = { ... }.✓ تم النسخ
    → :MCPHub يفتح واجهة الإدارة
  2. تثبيت خادم من المتجر
    :MCPHub marketplace — ابحث عن 'github' وثبّت.✓ تم النسخ
    → بدء الخادم وتسجيل الأدوات
  3. الاستخدام عبر Avante
    في دردشة Avante، اطرح سؤالاً — سيختار Avante أدوات MCP.✓ تم النسخ
    → استدعاءات الأدوات مرئية في مخرجات Avante

النتيجة: أدوات MCP قابلة للاستخدام داخل محررك دون تبديل السياق.

المزالق
  • Node ليست على PATH داخل Neovim — استخدم مسار مطلق في الإعدادات أو تأكد من أن Neovim ترث متغيرات بيئة الصدفة الخاصة بك

كيفية إعداد خوادم MCP محلية للمشروع تندمج مع العام

👤 المطورون الذين يعملون بلغات متعددة مع أدوات مختلفة لكل مشروع ⏱ ~15 min intermediate

متى تستخدمه: مشروع واحد يحتاج postgres MCP، وآخر يحتاج إلى MCP داخلي مخصص.

الخطوات
  1. إنشاء .mcphub.json5 في جذر المشروع
    عرّف خوادم محددة للمشروع في .mcphub.json5.✓ تم النسخ
    → الخوادم تحمل تلقائياً عند فتح المشروع
  2. التحقق من الدمج
    :MCPHub status — شاهد الخوادم العام منها والخاص بالمشروع.✓ تم النسخ
    → عرض مدمج

النتيجة: تحميل أدوات يدرك السياق لكل مشروع.

المزالق
  • حفظ الأسرار في .mcphub.json5 — استخدم مراجع متغيرات البيئة، أضف الملف إلى gitignore إذا كان يجب أن يحتوي على رموز

كيفية التكرار على خادم MCP مخصص من Neovim

👤 مؤلفو خوادم MCP ⏱ ~15 min advanced

متى تستخدمه: تبني خادماً وتريد تكراراً سريعاً.

الخطوات
  1. تفعيل وضع التطوير
    أضف خادمك مع dev=true في إعدادات mcphub.✓ تم النسخ
    → إعادة تحميل فوري عند حفظ الملف
  2. التكرار
    عدّل كود الخادم؛ ستعيد mcphub تحميله بشفافية.✓ تم النسخ
    → أدوات محدثة دون إعادة تشغيل Neovim

النتيجة: حلقة تطوير محكمة داخل Neovim.

التركيبات

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

mcphub-nvim + github

استخدام GitHub MCP من Neovim عبر دردشة Avante

ثبّت github MCP عبر المتجر، ثم اطلب من Avante عرض PRs المعهودة لي.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(plugin) :MCPHub Commands: status, marketplace, install, logs إدارة الخوادم free
(plugin) marketplace-install server_name إضافة MCP موثوق بسرعة free
(integration) Avante/CodeCompanion/CopilotChat tools Chat prompts استخدام الدردشة العادي 1 LLM call + tool calls

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

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

حصة API
لا شيء (الإضافة نفسها)
الرموز لكل استدعاء
يضيف قائمة الأدوات إلى تعليمات Avante/CC
التكلفة المالية
مجاني (MIT)
نصيحة
عطّل خوادم المتجر غير المستخدمة — كل واحد يضيف أدوات إلى ميزانية التعليمات الخاصة بك.

الأمان

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

الحد الأدنى من الصلاحيات: أياً كان ما يحتاجه كل MCP مثبت
تخزين بيانات الاعتماد: مراجع متغيرات البيئة في إعدادات mcphub
نقل البيانات الخارجي: لكل MCP مصب
لا تمنح أبدًا: لا تحفظ .mcphub.json5 مع الأسرار مباشرة

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

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

mcphub fails to start Node subprocess

قد لا تتضمن PATH الخاصة بـ Neovim Node. عيّن vim.env.PATH أو استخدم مسار مطلق.

تحقق: :!which node
Avante doesn't see MCP tools

تحقق من إصدار محول Avante — الإصدارات الأقدم لا تدعم MCP. حدّث.

Marketplace shows empty list

الشبكة/جدار الحماية يحجب عنوان URL المتجر. تحقق من سجلات :MCPHub.

OAuth flow stuck in browser

انسخ عنوان URL من سجلات :MCPHub والصقه يدوياً؛ قد لا يعمل إعادة التوجيه localhost من سياق Neovim.

البدائل

mcphub.nvim مقابل البدائل

البديلمتى تستخدمهاالمقايضة
CodeCompanion.nvim (native)تريد دردشة LLM دون إدارة MCPلا متجر، لا تدفقات OAuth
VS Code MCPتفضل VS Codeليست Neovim

المزيد

الموارد

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

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

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