أدوات MCP

البحث واسترجاع البيانات

أدوات تجد الأشياء حسب الكلمة الرئيسية أو النمط أو المعنى.

searchAxonExamples

بحث بالكلمات الرئيسية عبر كود Axon المفهرس. يدعم تصفية الفئات والعلامات. يعيد أفضل المطابقات برصيد صلة ومقتطف قصير.

searchAxonOperatorExamples

بحث محدد عن استخدام المشغلات — مرر >= أو == أو + وغيرها، ويعيد الخادم أمثلة حقيقية حيث يتم استخدام المشغل في السياق.

searchAxonDocs

بحث FlexSearch عبر شجرة الوثائق HTML و Markdown. وقت الاستعلام ~50 ميلي ثانية؛ النتائج تتضمن تسلسل العناوين ومقتطفات مختارة.

searchAxonRegex

بحث بنمط regex على غرار grep في الكود. يعيد الأسطر المطابقة مع N سطر من السياق المحيط (قابل للتكوين).

listAxonCategories / listAxonPatterns / getAxonPattern / getAxonExample

تصفح حسب الفئة أو احصل على دالة محددة حسب المعرف أو الاسم.

تحليل الدوال

أدوات تفكر في كيفية ارتباط الدوال ببعضها البعض.

findFunctionUsage

كل موقع استدعاء لدالة معينة، مع مسار الملف ورقم السطر.

getFunctionExamples

أمثلة استخدام حقيقية من قاعدة البيانات المفهرسة — مفيدة عندما تكون وثائق الدالة الخاصة بها ضعيفة.

getFunctionCallGraph

رسم بياني للمتصلين/المتصلين بهم بجذر عند دالة واحدة، إلى عمق قابل للتكوين.

getFunctionUsageStats

عدد الاستخدامات عبر قاعدة البيانات. الدوال غير المستخدمة والدوال المستخدمة بكثرة، ومقاييس الاقتران.

توليد الكود والتحقق منه

أدوات تكتب وتتحقق من الكود.

generateAxonCode

توليد يعتمد على النماذج. 33 نموذج YAML منسق يغطي سلاسل HVAC وحسابات الطاقة والكشف عن الأعطال وتجميع البيانات. يتم التحقق من الإخراج قبل إرجاعه.

validateAxonCode

يقوم بثلاث عمليات: التحقق الدلالي (هل يحلل بشكل صحيح؟ هل المعرفات صحيحة؟) وتحليل الأداء وفحص أفضل الممارسات.

parseAxonAst

حلل تعبير Axon إلى AST. مفيد لبناء أدوات عالية المستوى على أساس الخادم.

executeAxonCode

قيّم تعبير Axon مقابل مشروع SkySpark الأساسي. يعيد النتيجة بصيغة شبكة Haystack JSON.

commitAxonFunction

قم بتأكيد دالة في المشروع الأساسي. مع تفعيل functionVersioning، يتم الحفاظ على المراجعة السابقة.

تكامل SkySpark

أدوات للتحدث إلى مثيل SkySpark مباشر.

queryHaystack

قم بتنفيذ استعلام Haystack (read أو readAll أو history وغيرها) وأعد شبكة النتيجة.

listSkySparkProjects / switchSkySparkProject

عدّد المشاريع على المثيل المكوّن، وغيّر سياق المشروع النشط للاستدعاءات اللاحقة.

discoverProjectFunctions / discoverInstanceProjects

مشي عبر المشاريع المكونة للمثيل، وزامن الدوال المعرّفة من قبل المستخدم فيها إلى الفهرس المحلي، واجعلها قابلة للبحث.

getProjectSchema

أعد مخطط Haystack (العلامات والعلامات المرئية والأنواع المحددة) للمشروع.

setPrimaryProject / getPrimaryProject

إدارة سياق المشروع الأساسي المستخدم بواسطة executeAxonCode و commitAxonFunction.

تحليل الرسم البياني والتشابه

أدوات مبنية على أساس الرسم البياني للكود ومتجر التضمين المتجه.

getCallers / getCallees

الجيران المباشرون في رسم بياني الاستدعاء — من يستدعي X وما يستدعيه X.

getCodeImpact

تحليل نطاق الانفجار. بالنظر إلى دالة، أعد كل دالة مصبية ستتأثر بتغيير عليها.

findCodePath

أقصر مسار استدعاء بين دالتين. مفيد لتتبع كيفية وصول دالة ورقية من نقطة الدخول.

semanticCodeSearch

استعلامات باللغة الطبيعية تعيد الكود بالمعنى. يعمل "Find anything that resets daily energy counters at midnight" حتى عندما لا يحتوي أي كود حرفياً على تلك الكلمات.

findSimilarCode

تشابه متجه بين مقتطف كود مرفوع والقاعدة المفهرسة. مفيد للإلغاء والكشف عن إعادة الهيكلة.

getGraphMetrics / getMostCalledFunctions / getMostComplexFunctions

مركزية البينية والنقاط الفاصلة والتصنيفات المعقدة.

buildProjectGraph / buildProjectEmbeddings / getGraphStats

أدوات الصيانة لإعادة بناء وفحص الفهارس.

detectCycles

الكشف عن التبعيات الدائرية عبر رسم بياني الاستدعاء.

اتفاقيات معالجة الأخطاء

تعيد جميع الأدوات خطأ منظمًا عند الفشل بدلاً من الرمي. جسم الخطأ يتضمن code (مثل INDEX_NOT_FOUND أو SKYSPARK_UNREACHABLE أو INVALID_ARGUMENT) و message قابل للقراءة من قبل الإنسان. يجب على العملاء عرض code للمستخدمين النهائيين وتسجيل message لأغراض تصحيح الأخطاء.