graphlens-mcp يبني مخططًا بيانيًا للكود بأمر واحد ويخفض استهلاك التوكنات بمقدار 10–23 مرة

graphlens-mcp هو خادم MCP جديد مبني فوق محرك graphlens الذي ينشئ رسم بياني للكود الهيكلي بأمر واحد ويجعله متاحاً فوراً لوكيل ذكاء اصطناعي بدون عمل تكامل يدوي.

ما يمكن لمحرك graphlens أن يفعله يأخذ graphlens كود المصدر في

Python و TypeScript و Go و Rust و PHP ويوحده في رسم بياني موحد معروّف. تمثل العقد الرموز: الدوال والفئات والمتغيرات والطرق. تصف الحواف العلاقات: `CALLS` (استدعاء الدالة) و `HAS_TYPE` (النوع) و `INHERITS_FROM` (الوراثة).

تتلقى كل عقدة معرّف SHA-256 حتمي، مما يجعل النتيجة قابلة للتكرار بين التشغيلات وملائمة لخطوط أنابيب الوكيل القابلة للتخزين المؤقت. الفرق الرئيسي عن grep هو فهم الدلالات. يبحث grep عن نصوص سطراً تلو الآخر: لا يعرف ما إذا كانت السلسلة المجدة اسم دالة أم وسيط أم تعليق.

يعمل الرسم البياني على الرموز وعلاقاتها. إذا استدعى backend بايثون عميل TypeScript، فسيعبر الحافة `CALLS` حدود اللغة وتستمر في الرسم البياني. بالنسبة للمستودعات الأحادية والمشاريع fullstack، هذا حرج: تصبح التبعيات بين الطبقات كائنات صريحة، وليست سلاسل نصية يجب تتبعها يدويًا.

ما أظهرته القياسات على الكود الحقيقي قام المؤلف بتشغيل 936 اختبار على

apache/superset—وهو مشروع مفتوح المصدر يحتوي على حوالي 400 ألف سطر من الكود في Python و TypeScript. كان حد الاختبار نقاط الدخول للـ API `/api/v1/...`.

كان الهدف من كل اختبار الإجابة على أسئلة مثل "ماذا سيتغير إذا عدلت هذه الدالة؟" 936 تشغيل توفر استنتاجات ذات دلالة إحصائية. النتائج: تحليل التأثير: الرسم البياني أرخص من grep في تكلفة الرموز بمقدار 10–23 مرات الاستعلامات النقطية ("البحث عن التعريف"، "إظهار استدعاءات الطريقة"): الفرق ضئيل السلاسل بين اللغات (Python → TypeScript): grep لا يجد شيئًا—يبني الرسم البياني المسار الكامل الاستقرار: معرّفات SHA-256 توفر نتائج قابلة للتكرار عند إعادة تشغيل الوكيل حيث تحتاج إلى فهم ما يتعطل عند تغيير دالة أو فئة—يفوز الرسم البياني عدة مرات. حيث يكفي العثور على سلسلة حسب النمط—الفرق ضئيل.

يكون توفير الرموز ملحوظاً بشكل خاص في قواعد الكود الكبيرة ذات الاتصال العالي بين الوحدات.

من المحرك إلى المنتج النهائي وصفت المقالات السابقة محرك graphlens

نفسه—الميكانيكا الداخلية لبناء الرسم البياني. لكن المحرك ليس منتجاً. لتوصيله بوكيل ذكاء اصطناعي، كان عليك تثبيت التبعيات بشكل مستقل وتكوين API وكتابة كود التكامل لبروتوكول معين. بالنسبة لمعظم المطورين، كانت هذه حاجزاً خطيراً.

"المحرك ليس منتجاً. لتوصيل graphlens فعلاً بوكيل، pip install وواجهة

برمجية تطبيقات ليسا كافيين. تحتاج إلى كتابة الكثير من كود التكامل"، يعترف المؤلف. graphlens-mcp يسد هذه الفجوة. تحت الغطاء نفس المحرك، لكن فوقه خادم MCP جاهز يقبل الطلبات من الوكيل بصيغة موحدة فور التثبيت. أصبح MCP (Model Context Protocol) المعيار الفعلي لدمج الأدوات الخارجية بنماذج اللغة—يدعمه Claude و GPT وغالبية أطر العمل الحديثة للذكاء الاصطناعي. graphlens-mcp متوافق مع أي وكيل يدعم هذا البروتوكول، بدون تكوين إضافي. التثبيت أمر واحد. وفقاً للمؤلف، من التثبيت إلى أول نتيجة حقيقية على مشروعك الخاص يستغرق خمس دقائق. المنتج في مرحلة ألفا، ترخيص MIT، موزع مجاناً.

ما يعنيه هذا رسم بياني الكود الهيكلي كأداة لوكلاء الذكاء الاصطناعي

ليست نظرية بل ممارسة قابلة للقياس برقم ملموس على كود حقيقي. graphlens-mcp يخفض حاجز الدخول للفريق الذي يبني وكلاء لمراجعة الكود أو إعادة الهيكلة أو تحليل التبعيات: بدلاً من تجميع التكامل بأنفسهم، يحصلون على أداة جاهزة مع كفاءة موثقة. المصدر المفتوح والترخيص المجاني يتيحان تجربتها بدون أي التزامات تجارية.