عن المشروع

jCodeMunch MCP هو خادم بروتوكول سياق النموذج (MCP) مصمم لتقليل استهلاك رموز الذكاء الاصطناعي أثناء استكشاف الشيفرة. يستخدم tree-sitter لتحليل الشيفرة المصدرية إلى فهرس محلي للرموز (الدوال، الفئات، الطرق، الثوابت) مع إزاحات على مستوى البايت، ما يسمح للوكلاء باسترجاع الشيفرة المطلوبة فقط بدلاً من قراءة الملفات كاملة. تشمل القدرات الرئيسية: - استرجاع على مستوى الرمز: يعيد `get_symbol_source` أجسام الدوال الدقيقة، ويجد `search_symbols` الرموز بالاسم، ويقدم `get_file_outline` ملخصات بنيوية. - استعلامات بنيوية: `find_importers`، `get_blast_radius`، `get_call_hierarchy`، `find_dead_code`، `get_changed_symbols`، `get_hotspots`، وعمليات بحث عن الأنماط المضادة المعتمدة على AST. - تجميع سياق المهمة: يصنّف `assemble_task_context` نية المهمة وينفّذ تسلسل الأدوات المناسب ضمن ميزانية رموز. - فحوصات السلامة: `check_edit_safe`، `check_delete_safe`، `get_pr_risk_profile`، و`plan_refactoring` مع كتل جاهزة للتعديل، إضافة إلى التكامل مع تشخيصات مدققات الأنواع (mypy، pyright، tsc، ruff). - درجات الثقة، وعلامات الحداثة، وعقود التغطية، وحجب الأسرار، ومراجع موثّقة بالمترجم المعتمدة على SCIP. - حداثة تلقائية للفهرس عبر أوضاع المراقبة، وخطافات الوكلاء، وإضافة VS Code. تدّعي اختبارات الأداء تحقيق انخفاض بمقدار 28.3 مرة في الرموز مقارنة بخط أساس grep-and-read (توفير 96.5%) عبر ثلاثة مستودعات عامة، مع توفير لكل مستودع يتراوح بين 15.6 و39.7 مرة. وأفاد اختبار A/B مستقل على قاعدة شيفرة Vue 3 إنتاجية بتوفير في طبقة الأدوات بنسبة 15-25% وتحسّن معدلات النجاح. يتم التثبيت عبر `uv tool install jcodemunch-mcp` أو `uvx jcodemunch-mcp`، مع أمر `init` يضبط عملاء MCP تلقائياً ويثبّت سياسة توجيه CLAUDE.md. يدعم أكثر من 70 لغة عبر tree-sitter، والمستودعات الأحادية، والفهرسة التدريجية. تصميم محلي أولاً مع تخزين الفهارس في `~/.code-index/`؛ وعدّاد توفير مجهول اختياري (قابل للإلغاء). الترخيص مزدوج الاستخدام: مجاني للاستخدام الشخصي، وتُطلب تراخيص تجارية للاستخدام المدرّ للدخل.