MCP Fantom

علّم مساعدك الذكي Fantom و Axon -- سواء كان لديك GPU الخاص بك أم لا.

MCP Fantom يعطي مساعدك الذكي معرفة عملية بقاعدة أكواد Fantom و Haxall و SkySpark -- ليس فقط التوثيق الخاص بها، بل الكود الفعلي: ما الذي يستدعي ما، وما الذي تغير الأسبوع الماضي، وأي دالة تفعل الشيء الذي تصفه باللغة الإنجليزية البسيطة.

يقوم بفهرسة مصدر Fantom ودوال SkySpark Axon والتوثيق على fantom.org و haxall.io؛ ويضمن جميعها للبحث الدلالي؛ ويبني رسم بياني حقيقي للاستدعاءات؛ ويعرّضها جميعًا عبر Model Context Protocol، جنبًا إلى جنب مع لوحة تحكم ويب لتشغيل ومراقبة الفهرسة.

جديد في 1.0: OpenRouter

التضمين لا يحتاج لعد GPU تحت مكتبك. يتم توجيه كل دور استدلال -- تضمين الأكواد، تضمين النصوص، إعادة الترتيب، مساعد الأكواد، وحلقة الاسترجاع -- بشكل مستقل إلى المضيفات المحلية، أو OpenRouter، أو كليهما في نفس الوقت. قم بتشغيله بالكامل في السحابة من جهاز محمول، أو بالكامل على أجهزتك الخاصة في مصنع معزول عن الشبكة، أو وزّع العمل على كلا المجموعتين مع السحب من قائمة انتظار واحدة.

لا يزال ينقل SkySpark

غيّرت SkySpark 4.0 تنسيق الامتداد. نقل امتداد أو موصل في العالم الحقيقي يدويًا هو كدح من إعادة كتابة using، وتحويلات سلاسل Axon، وملفات مكتبة Xeto جديدة تماما -- مع مترجم يعض اللحظة التي تفتقد فيها سطرًا واحدًا. يقوم MCP Fantom بإعادة كتابة عبارات using، وتحويل سلاسل Axon، وتوليد ملفات Xeto، والتحقق مع مترجم Fantom، وأخذ علامة نسخ احتياطي Git في الطريق.

إذا فشل النقل، قم بالتراجع باستدعاء أداة واحدة. الرحلة بأكملها قابلة للمقارنة وقابلة للعكس وموضحة.

من هي بصددها

مؤلفو الامتدادات الذين ينقلون SkySpark 3.x pods إلى 4.0
مدمجو Haxall يبنون الموصلات والدوال والتطبيقات في Fantom
مطورو SkySpark الذين يريدون وظائف Axon الخاصة بهم قابلة للبحث حسب المعنى وليس grep
مطورو مساعدة الذكاء الاصطناعي الذين يحتاجون إلى سياق Fantom دقيق، وليس بناء جملة بالوهم

قمرة الهجرة

انقل SkySpark 3 إلى 4 بدون تشنج اليد

أداة واحدة تعيد كتابة امتدادك. أخرى تلتزم بها. الثالثة تتراجع عنها. كل تغيير قابل للمقارنة، والمترجم يتحقق، و Git يبقي شبكة الأمان.

الهجرة: جارية modbus-connector

67%

مصدر SkySpark 3.x

ناتج SkySpark 4.0

1using sys

2using skyspark::ext

3using skyspark::folio

4

5@Ext const class MyConnector : ConnExt {

6 override Str sort := "connector"

7 override Str moniker := "myCon"

8

9 Str axonWatch() { "read(point and siteRef == @hq)" }

10 Str axonSub() { "readAll(point)" }

11}

12

1using sys

2using haxall::ext

3using haxall::folio

4

5@Ext const class MyConnector : ConnExt {

6 override Str sort := "connector"

7 override Str moniker := "myCon"

8 // تم نقل Axon إلى funcs.xeto

9 Str axonWatch() { "axon:MyConnector.watch" }

10 Str axonSub() { "axon:MyConnector.sub" }

11}

12

using rewrites: 12 axon strings: 8 xeto files: 3 generated compiler: PASS git: pre-skyspark-4x-backup tag created

تم التحقق من الناتج بواسطة fan compile. التراجع متاح عبر rollbackMigration حتى يتم استدعاء commitMigration.

الفهرسة البطيئة

الخادم يجيب قبل انتهاء الفهرس

تحجب معظم خوادم البحث العميل لمدة 30 إلى 60 ثانية عند بدء التشغيل الأول بينما تقوم بالفهرسة. يبدأ MCP Fantom في أقل من ثانية واحدة. تستجيب الأدوات على الفور -- يسخن FlexSearch أولاً، ثم الوحدات المحلية، ثم الفقرات المضمنة. المساعد لا ينتظر أبداً.

تتدهور الاستعلامات بشفافية. إذا لم تكن الفقرات جاهزة، تندرج الأدوات الدلالية إلى البحث بالكلمات الرئيسية. يحصل المساعد على إجابة مع ملاحظة حول الجودة، وليس انتهاء المهلة الزمنية.

MCP Fantom

جاهز

HTML docs (cheerio) 100%

4,187 من 4,187 صفحة مفهرسة

Local .fan pods 78%

1,246 من 1,600 pod تم تحليلها

Embeddings (LanceDB) 45%

723 من 1,600 متجه محسوب

Call graph (graphology) 12%

192 من 1,600 وظيفة مرتبطة

boot 0s tools 1s docs 8s full index 47s

البحث الدلالي LanceDB

"وظائف تطبيع الوحدات" cosine بحث

normalizeUnit(val, target)

يوحد قيمة رقمية إلى رمز وحدة الهدف.

0.91

convertUnit(point, u)

تحويل قيمة النقطة إلى الوحدة المحددة.

0.87

toEngUnit(v, sym)

أرجع تمثيل الوحدة الهندسية لقيمة خام.

0.82

مجتمعات الكود (Louvain)

تطبيع الوحدة trio parsing قراءات الموصل أداة الموصل

ذكاء الكود

الفهم الدلالي، وليس مجرد تطابق نصي

semanticCodeSearch و findSimilarCode يدمجان كود Fantom الخاص بك في مساحة متجهة. اسأل عن "الوظائف التي تطبيع الوحدات" واحصل على نتائج تشترك في البنية، وليس الكلمات الرئيسية.

عثور Graphology مع تجميع Louvain على المجتمعات الطبيعية في قاعدة الأكواد الخاصة بك -- أي أنواع تتماشى معاً، وأي منها لا تفعل. getCodeImpact يتتبع كيفية انتشار التغيير. getCallers و getCallees أكمل سطح الاستدعاء.

semanticCodeSearch findSimilarCode getCallers getCallees getCodeImpact

سلامة الهجرة

كل هجرة على بعد عكس واحد

migrateSkySpark4x ينشئ علامة Git قبل أن يكتب بايت واحد. إذا فشل أي شيء -- خطأ المترجم، عدم تطابق التحقق، حدسك -- rollbackMigration يستعيد المستودع إلى الحالة الدقيقة قبل التشغيل.

commitMigration مقصود. لا يتم دمج أي شيء في سجل العمل الخاص بك حتى تقبل الناتج. حتى ذلك الحين، تعيش الهجرة على فرع، مع علامة احتياطية، جاهزة للتجاهل.

خط زمني Git مستودع mcp-fantom

commitMigration merged

ghi789

تم كتابة جميع ملفات Xeto؛ تم تأكيد PASS المترجم.

تطبيق فرع الهجرة

def456

إعادة كتابة using + تحويل Axon + توليد Xeto.

tag: pre-skyspark-4x-backup

abc123

تم إنشاء علامة النسخ الاحتياطي تلقائيًا قبل تشغيل الهجرة.

حالة ما قبل الهجرة

abc123

حالة المستودع قبل استدعاء migrateSkySpark4x.

أدوات الهجرة

migrateSkySpark4x

قم بتشغيل إعادة الكتابة الكاملة.

commitMigration

قبول الناتج.

rollbackMigration

استعادة إلى علامة النسخ الاحتياطي.

resources/list --> 13 مورد

create-pod

هيكل pod جديد من البداية إلى النهاية.

5 خطوات · markdown

use-fanr

نشر pod عبر fanr.

6 خطوات · markdown

haxall-basics

بناء أول امتداد Haxall الخاص بك.

8 خطوات · markdown

unit-testing

إعداد اختبارات وحدة fant.

4 خطوات · markdown

+ تسعة آخرون، بما فيهم skyspark-4x-migration، connector-workflow، و xeto-spec-guide.

سير العمل الموجه

ما وراء الأدوات -- أدلة قابلة للقراءة

موارد MCP عبارة عن وثائق markdown يمكن للمساعد قراءتها عند الحاجة. يأتي MCP Fantom مع ثلاثة عشر: هيكل pod، دليل نشر fanr، شرح امتداد Haxall، مقدمة اختبار وحدة fant، كتاب SkySpark 4.x، دليل مواصفات Xeto، والمزيد.

عندما يسأل المطور "كيف أبدأ؟"، يسحب المساعد المورد الصحيح، يختصره، وينتقل. كل سير عمل إصدار جنباً إلى جنب مع الخادم.

✓ Markdown خطوة بخطوة
✓ قابل للاكتشاف عبر resources/list
✓ النسخة مع الخادم
✓ من السهل إضافة المزيد

توجيه المزود

GPU الخاص بك أو OpenRouter أو كليهما في نفس الوقت

يتم توجيه كل دور استدلال بشكل مستقل. يمكن للتضمين أن ينشر عبر وحدات GPU المحلية و OpenRouter السحب من قائمة انتظار واحدة، بينما تعمل إعادة الترتيب فقط السحابة وحلقة الاسترجاع تبقى محلية. أربع سياسات، خمس أدوار، مجموعة لكل دور وتغييرها في وقت التشغيل.

يصبح الدور الموجه نحو OpenRouter حاوية افتراضية: قدرة تقديم حقيقية بدون GPU وبدون VRAM خلفه، مسجل كمزود منطقي خاص به حتى يتمكن المجدول من تسليم العمل له مثل أي مضيف آخر. لا يعني النموذج المحلي أي متطلبات أجهزة محلية -- MCP Fantom يفهرس قاعدة أكواد من جهاز محمول.

✓ aggregate -- محلي وسحابة في مجموعة واحدة
✓ backup -- محلي أولاً، مع احتفاظ السحابة بالاحتياطي
✓ local -- معزولة، لا شيء يترك الشبكة
✓ cloud -- OpenRouter فقط، لا GPU مطلوب

التوجيه

5 أدوار

code-embedding

وحدتي GPU محليتان + حاوية افتراضية واحدة

مجمع

embedding

محلي أولاً، سحابة في الاحتياطي

احتياطي

reranker

gpu-01-OR-Reranker

سحابة

code-assistant

توليد الأكواد والتحقق

سحابة

rlm

حلقة الاسترجاع خلف askCodebase

محلي

بوابة المتجهات: PASS جيب التمام الأدنى 0.99 المصب مثبت ميزانية السحابة: مجموعة تصريح مشتركة

يجب أن يتطابق مزود السحابة مع محرر المرجع ضمن 0.99 جيب التمام، بالضبط البعد المهيأ، قبل أن يكتب صفًا واحدًا.

مجموعة التقنيات

TypeScript Model Context Protocol OpenRouter FlexSearch LanceDB LadybugDB (Kuzu) HuggingFace Transformers Prisma SQLite Tree-sitter Graphology + Louvain Cheerio

البنية

عميل MCP --> النقل (stdio | HTTP + OAuth) --> Lazy Indexer (بدء تشغيل غير محظور) --> Cheerio Crawler (fantom.org, haxall.io) --> Tree-sitter (Fantom, Axon, Xeto grammars) --> Provider Router (لكل دور: محلي | سحابة | مجمع | احتياطي) --> أجهزة جانبية GPU محلية --> حاويات OpenRouter الافتراضية --> بوابة التوافق المتجهة + ميزانية سحابية واحدة مشتركة --> LanceDB (vectors) + LadybugDB (call graph) + FlexSearch (keyword) --> Migration Engine (SkySpark 3 -> 4) --> Xeto Generator (lib.trio, funcs.xeto, lib.xeto) --> Git (backup tag + rollback)

الإمكانيات

41 أداة MCP -- عبر البحث في التوثيق، البحث الدلالي عن الأكواد، تحليل رسم بياني الاستدعاءات، سجل الأكواد، توليد الأكواد، وأتمتة الهجرة
توجيه المزود لكل دور -- code-embedding، embedding، reranker، code-assistant، و rlm كل واحد يأخذ سياسته الخاصة: local، cloud (OpenRouter فقط)، aggregate (كليهما في مجموعة واحدة)، أو backup (محلي أولاً، مع احتفاظ السحابة بالاحتياطي)
الفهرسة البطيئة -- يبدأ الخادم في ثوان ويجيب على الفور؛ تعمل الفهرسة في الخلفية وتتدهور الأدوات بأناقة أثناء ذلك
البحث الدلالي -- LanceDB خلف فهرس ANN، مع محول متقاطع اختياري أو إعادة ترتيب OpenRouter
الإجابة عن الأسئلة باللغة الطبيعية -- askCodebase يشغل حلقة استرجاع على الفهرس وينتج إجابة مقتبسة
رسم بياني حقيقي للاستدعاءات -- getCallers، getCallees، getCodeImpact، و getCodeNeighbors الإجابة على الأسئلة الهيكلية من قاعدة بيانات الرسم البياني المضمن، وليس عن طريق grep
دعم Axon -- وظائف SkySpark Axon، من مجلدات proj/ المتزامنة أو تصدير المكتبة دون اتصال، يتم تحليلها باستخدام نحو tree-sitter مخصص بحيث تصل القطع إلى حدود البيان وتظهر خلايا defcomp كواجهة المكون
السجل -- whatChangedRecently، getSymbolHistory، explainSymbolChange، و diffIndexRuns الإجابة على كيفية وصول الكود إلى هذه النقطة
ترقية SkySpark 4.x -- إعادة كتابة آلية لعبارات using وسلاسل Axon، توليد ملف Xeto (lib.trio، funcs.xeto، lib.xeto)، التحقق من المترجم، علامة النسخ الاحتياطي Git، تراجع بدعوة واحدة
13 مورد سير عمل -- أدلة markdown قابلة للقراءة، من create-pod إلى skyspark-4x-migration
نقل مزدوج -- stdio و HTTP، مع لوحة تحكم Next.js لتغطية الفهرس وتقدم التضمين وتوجيه المزود

السحابة بدون أخطاء

إسقاط مضمن سحابي في فهرس بني GPU محلي هو كيف يتعفن الاسترجاع بهدوء -- توقف المسافة الجيبية عن أن يكون قابلاً للمقارنة ولا شيء يخبرك. يعامل MCP Fantom ذلك كشرط مسبق صارم بدلاً من تحذير:

بوابة التوافق المتجهة -- يضمن مزود السحابة نصوص الاختبار جنبًا إلى جنب مع مزود المرجع ويجب أن يمسح الحد الأدنى بقيمة 0.99 جيب التمام، بالضبط البعد المهيأ، قبل أن يكتب صفًا واحدًا. يأتي محرر الاستعلام دائمًا من المجموعة التي بنت تلك الصفوف.
المصادر المثبتة -- لا يضمن مضيفا OpenRouter يخدمان نفس نموذج slug متطابقة المتجهات، لذا يجب أن يسمي كل مسار تضمين المصب الخاص به. إعادة الترتيب بدون حالة ولا تحتاج إلى دبوس.
ميزانية مشتركة واحدة -- يقيد OpenRouter معدل البريد لكل مفتاح، وليس لكل مستدعي، لذا يتم رسم جميع التزامن السحابي من مجموعة تصريح عام واحد، يتم تحجيمها من الكمون المقاس من خلال قانون Little. يقلل 429 الميزانية إلى النصف ويتراجع مع الرجفة؛ تعمل وحدات GPU المحلية بشكل مستقيم خلالها.
مفاتيح الكتابة فقط -- يمر مفتاح API إلى الجهاز الجانبي الذي يستخدمه. لم يتم كتابتها أبدًا في التكوين، ولم يتم تسجيلها أبدًا، ولم يتم إرجاعها من أي نقطة نهاية.

سطح الأداة (جزئي)

searchFantomCode، semanticCodeSearch، askCodebase، findSimilarCode، getFantomType، getFantomFunction، searchLocalDocs، searchVersionedApi، listFantomPods، getCallers، getCallees، getCodeImpact، getCodeNeighbors، whatChangedRecently، getSymbolHistory، explainSymbolChange، diffIndexRuns، axonSearch، axonFunction، generateFantomCode، migrateSkySpark4x، commitMigration، rollbackMigration، بالإضافة إلى إدارة المشروع والمثيل.

المتطلبات

Node.js 20+
مزود تضمين -- نموذج محلي أو مفتاح OpenRouter
سلسلة أدوات Fantom و Haxall المحلية للتحقق من مترجم الهجرة
مستودع Git للنسخ الاحتياطية للهجرة

MCP Fantom

جديد في 1.0: OpenRouter

لا يزال ينقل SkySpark

من هي بصددها

انقل SkySpark 3 إلى 4 بدون تشنج اليد

الخادم يجيب قبل انتهاء الفهرس

الفهم الدلالي، وليس مجرد تطابق نصي

كل هجرة على بعد عكس واحد

ما وراء الأدوات -- أدلة قابلة للقراءة

GPU الخاص بك أو OpenRouter أو كليهما في نفس الوقت

التفاصيل التقنية

مجموعة التقنيات

البنية

الإمكانيات

السحابة بدون أخطاء

سطح الأداة (جزئي)

المتطلبات

هل أنت مهتم بهذا المشروع؟