/ الدليل / الملعب / pi-mcp-adapter
← كل الخوادم ↗ GitHub
● مجتمع nicobailon ⚡ فوري

pi-mcp-adapter

بواسطة nicobailon · nicobailon/pi-mcp-adapter

ربط 200 أداة MCP بعامل Pi البرمجي مقابل ~200 رمز — أداة وكيل واحدة تحمّل الخوادم بشكل كسول عند استدعاؤها فقط.

pi-mcp-adapter هو محول لـ Pi (badlogic/pi-mono)، وهو عامل برمجي بسيط. بدلاً من تحميل مخطط كل أداة MCP بحرص في سياق Pi، فإنه يفضح أداة وكيل mcp واحدة (~200 رمز) تدعم استدعاءات search وdescribe وtool. تبدأ الخوادم بشكل كسول وتقطع الاتصال تلقائياً بعد الخمول.

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

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

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

عرض مباشر

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

pi-mcp-adapter.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "pi-mcp-adapter": {
      "command": "npx",
      "args": [
        "-y",
        "pi-mcp-adapter"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "pi-mcp-adapter": {
      "command": "npx",
      "args": [
        "-y",
        "pi-mcp-adapter"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "pi-mcp-adapter": {
      "command": "npx",
      "args": [
        "-y",
        "pi-mcp-adapter"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "pi-mcp-adapter": {
      "command": "npx",
      "args": [
        "-y",
        "pi-mcp-adapter"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "pi-mcp-adapter",
      "command": "npx",
      "args": [
        "-y",
        "pi-mcp-adapter"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "pi-mcp-adapter": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "pi-mcp-adapter"
        ]
      }
    }
  }
}

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

claude mcp add pi-mcp-adapter -- npx -y pi-mcp-adapter

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

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

استخدامات عملية: pi-mcp-adapter

تشغيل Pi مع 10+ خوادم MCP دون استنزاف نافذة السياق

👤 المستخدمون المتقدمون لعامل Pi البرمجي ⏱ ~20 min intermediate

متى تستخدمه: عندما تريد filesystem و git و github و postgres و playwright و fetch و firecrawl — أكثر مما يمكن لـ Pi تحميله بحرص.

المتطلبات الأساسية
  • تثبيت Pi — انظر badlogic/pi-mono
الخطوات
  1. تثبيت المحول
    شغّل pi install npm:pi-mcp-adapter وأعد تشغيل Pi.✓ تم النسخ
    → المحول مدرج في إضافات Pi
  2. تكوين جميع MCPs الخاصة بك
    أضف MCPs الخاصة بـ filesystem و git و github و postgres إلى pi-mcp-adapter في الوضع الكسول.✓ تم النسخ
    → الخوادم مسجلة؛ لا توجد تكلفة إقلاع
  3. الاستخدام عبر البحث
    استخدم mcp({search: 'list files'}) للعثور على الأداة الصحيحة، ثم استدعها.✓ تم النسخ
    → ظهور الأداة ذات الصلة؛ ثم استدعاؤها

النتيجة: نظام بيئي MCP كامل متاح داخل Pi، مع بصمة سياق صغيرة جداً.

المزالق
  • البحث لا يجد أداة لأن الوصف سيء — رقِّ الأدوات المتكررة إلى 'أدوات مباشرة' حتى يراها Pi بحرص

رقِّ أدواتك الثلاث الأكثر استخداماً من MCP إلى أدوات Pi من الدرجة الأولى

👤 المطورون الذين يستخدمون Pi يومياً ⏱ ~10 min beginner

متى تستخدمه: عندما تلاحظ أن Pi يستدعي mcp({search: ...}) في كل مرة قبل استخدام filesystem read — أضفه كأداة مباشرة لتخطي الرقصة.

الخطوات
  1. تحديد الأدوات الساخنة
    أي استدعاءات mcp tool تظهر الأكثر في سجلات جلسة Pi الأخيرة؟✓ تم النسخ
    → قائمة Top-N
  2. وضع العلامة كمباشرة
    كوّن هذه كأدوات مباشرة في إعدادات pi-mcp-adapter.✓ تم النسخ
    → الأدوات تظهر الآن كأدوات Pi من الدرجة الأولى

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

المزالق
  • عدد كبير جداً من الأدوات المباشرة = يهزم الغرض — احتفظ بعدد الأدوات المباشرة عند ≤5؛ رقِّ فقط إذا كان التكرار مرتفعاً

استخدام خوادم MCP المحمية بـ OAuth (مثل Linear و Slack) مع Pi

👤 مستخدمو Pi على MCPs المؤسسات ⏱ ~15 min intermediate

متى تستخدمه: عندما يتطلب خادم MCP الخاص بك OAuth وتفضل عدم حرفية تحديث الرمز يدوياً.

الخطوات
  1. تفعيل autoAuth
    اضبط autoAuth: true في تكوين pi-mcp-adapter لخادم linear.✓ تم النسخ
    → Pi يفتح المتصفح عند الاستخدام الأول
  2. تفويض في المتصفح
    وافق على طلب النطاق؛ يتم حفظ الرموز.✓ تم النسخ
    → الاستدعاءات اللاحقة تستخدم الرموز المحدثة تلقائياً

النتيجة: تكاملات MCP المحمية بـ OAuth 'تعمل ببساطة' في Pi.

المزالق
  • الرموز مخزنة بدون تشفير على القرص — استخدم دليل المنزل المشفر أو جسر مفاتيح نظام التشغيل

التركيبات

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

pi-mcp-adapter + filesystem + git-2 + github

حلقة تطوير كاملة داخل Pi مع تحميل أداة كسول

سجّل filesystem و git و github عبر pi-mcp-adapter في الوضع الكسول.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
mcp {search?: str} | {describe?: str} | {tool?: str, args?: JSON-string} وكيل عام — الأداة الوحيدة التي يراها Pi افتراضياً ~200 tokens eager + on-demand tool execution
/mcp-auth <server> server name تشغيل OAuth يدوياً لخادم معين free

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

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

حصة API
لا توجد حصة خاصة بها — توكيل إلى MCPs الأساسية
الرموز لكل استدعاء
~200 رمز كسب حرص مقابل N*~500 لقائمة الأدوات الكاملة
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
ابدأ بالكسول. رقِّ الأدوات إلى المباشرة فقط عندما تُظهر القياسات أن Pi يستدعيها ≥5× لكل جلسة.

الأمان

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

تخزين بيانات الاعتماد: رموز OAuth في ~/.pi/mcp-adapter/ — عامل كحساس
نقل البيانات الخارجي: يعتمد على MCPs الأصلية المكونة

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

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

mcp({tool: ...}) says 'tool not found'

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

OAuth loop never completes

قد يكون منفذ رد الاتصال المحلي للمحول مسدوداً. تحقق من أن عنوان URL لإعادة التوجيه يطابق ما هو مسجل لدى المزود.

Server starts but tool calls hang

توقفت MCP الأصلية بصمت. التبديل إلى الوضع الحرص مؤقتاً لرؤية خطأ الإقلاع.

تحقق: pi-mcp-adapter logs

البدائل

pi-mcp-adapter مقابل البدائل

البديلمتى تستخدمهاالمقايضة
تكامل MCP الخامعندما تقوم بتشغيل Pi مع 1-2 خوادم MCP فقطأبسط، لكن يستهلك السياق عند إضافة خوادم
mcp-gatewayعندما تحتاج إلى أمان/حذف معلومات التعريف الشخصية عبر MCPs العديدة (ليس فقط كفاءة الرموز)بوابة Python؛ موجهة نحو الأمان أكثر من توفير الرموز

المزيد

الموارد

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

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

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