Install
npx -y @jetbrains/mcp-proxyلمن يناسب
يناسب من ما زال على IDE قديمة من JetBrains ويحتاج توجيه طلبات عميل MCP إلى الـ IDE. الأدلة تنص: هذا الخادم يوجّه طلبات العميل إلى JetBrains IDE.
لكن هذا المستودع لم يعد يُصان. القدرة الأساسية دُمجت منذ 2025.2 في كل IDE مبنية على IntelliJ: دعم SSE مدمج، ووكيل JVM لـ STDIO، لذا لم تعد حزمة NPM هذه لازمة. إن كان الـ IDE لديك 2025.2 أو أحدث فلا تثبّت هذه الحزمة.
تابع فقط إن كنت ما زلت تحتاج صراحة مسار NPM التاريخي. تحتاج أيضًا إلى إضافة MCP Server، ويجب أن يكون Node.js 18 أو أعلى. الأدلة لا تسرد منتجات العملاء؛ التغطية تتوقف عند «JetBrains IDE».
أول محاولة في 3 دقائق
إن كان IDE ≥ 2025.2: المسار الرئيسي هو MCP المدمج في الـ IDE (SSE / وكيل JVM STDIO). توقف هنا ولا تشغّل npx أدناه.
إن كنت ما زلت تستخدم هذه الحزمة، اضبط:
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
وثبّت الإضافة: https://plugins.jetbrains.com/plugin/26071-mcp-server
المتطلبات: الـ IDE مفتوح؛ الإضافة مثبتة؛ Node 18+ (Node 16 يظهر Cannot find module 'node:path'). الوكيل يتصل افتراضيًا بالـ IDE على 127.0.0.1 ويلامس الـ IDE والمشروع المحليين — وهذا ليس إعدادًا بلا قراءة محلية.
موضع الإعداد: command / args لـ MCP في العميل. عند فتح أكثر من IDE أضف أيضًا:
"env": {
"IDE_PORT": "<port of IDE's built-in webserver>"
}
أول استدعاء منخفض المخاطر: طلب اتصال واحد يسأل الـ IDE عبر الوكيل عن معلومات قراءة فقط للمشروع الحالي (مثل أي مشروع مفتوح). الأدلة لا تسمّي أدوات ولا معاملات. لا تبدأ بتعديل ملفات أو تشغيل بناء أو عمليات كتابة في الـ IDE.
إشارة النجاح: عملية الوكيل ترتفع، والعميل لم يعد يبلغ أنه لا يصل إلى الـ IDE؛ وعند تعدد النسخ يشير IDE_PORT إلى التي اخترتها. إن وصل إلى نسخة خاطئة فغيّر المنفذ أولًا ولا تفترض أن الافتراضي صحيح.
حالات الاستخدام
الحالة 1: وصل عميل MCP بـ IDE واحدة قيد التشغيل. استخدم 127.0.0.1 الافتراضي وإعداد npx أعلاه (أو المدمج في 2025.2+). الأدلة تضمن فقط «توجيه الطلبات إلى الـ IDE» ولا تسرد الأدوات. ما يمكن تأكيده: وصل الطلب إلى الـ IDE المحلية.
الحالة 2: عدة IDE فيها MCP مفتوحة على هذا الجهاز وتريد تثبيت واحدة. أضف IDE_PORT في الإعداد. الأدلة تقول أيضًا إنه يمكن تحديد address/host مختلف، لكن locator قُطع عند «specify a different address/host:» ولم يعطِ اسم متغير البيئة. اعتبر IDE_PORT وحده طريقة الاختيار المؤكدة؛ لا تختلق متغير host.
حدود الاستخدام
المستودع لم يعد يُصان؛ في 2025.2+ استخدم القدرة المدمجة. المسار التاريخي يعتمد على @jetbrains/mcp-proxy وإضافة MCP Server وNode 18+. افتراضيًا يتصل فقط بـ 127.0.0.1 المحلي. لا أسماء أدوات ولا نموذج صلاحيات ولا undo رسمي. توجيه طلبات العميل إلى الـ IDE يعني تعريض المشروع وقدرات الـ IDE لذلك العميل. الأدلة لا تكتب كيف تُعرض المنافذ ولا خطوات الأمان للتعريض غير المحلي.