MCP Fantom
Fantom ve Axon için Anlamsal Kod Arama -- Yerel GPU veya OpenRouter
AI asistanınıza Fantom ve Axon öğretin -- kendi GPU'nuz olsun veya olmasın.
MCP Fantom, bir AI asistanına Fantom, Haxall ve SkySpark kod tabanı hakkında çalışan bilgi verir -- sadece belgeleri değil, gerçek kodu: neyin neyi çağırdığını, geçen hafta neyin değiştiğini ve hangi fonksiyonun düz İngilizce ile açıkladığınız şeyi yaptığını.
Fantom kaynağını, SkySpark Axon fonksiyonlarını ve fantom.org ile haxall.io belgelerini indeksler; tümünü anlamsal arama için gömülü hale getirir; gerçek bir çağrı grafiği oluşturur; ve Model Context Protocol üzerinden tümünü ortaya koymakla birlikte, indekslemeyi çalıştırmak ve izlemek için bir web panosunu da sağlar.
1.0'da Yeni: OpenRouter
Gömülü hale getirme artık masanızın altında GPU'ya ihtiyaç duymamaktadır. Her çıkarım rolü -- kod gömülü hale getirme, metin gömülü hale getirme, yeniden sıralama, kod asistanı ve alma döngüsü -- bağımsız olarak yerel ana bilgisayarlara, OpenRouter'a veya her ikisine de aynı anda yönlendirilir. Bunu laptop'tan tamamen bulutta çalıştırın, hava boşluklu bir tesiste tamamen kendi donanımınızda çalıştırın veya her iki havuza da yayılarak bir kuyruktan çekin.
Yine de SkySpark'ı Taşır
SkySpark 4.0, uzantı biçimini değiştirdi. Gerçek dünya uzantısının veya bağlayıcısının el ile taşınması, using yeniden yazma, Axon dizesi dönüştürme ve yepyeni Xeto kütüphane dosyaları işi sıkıcı bir iştir -- bir satırı kaçırdığınız an geri iten bir derleyici ile. MCP Fantom, using ifadelerini yeniden yazar, Axon dizelerini dönüştürür, Xeto dosyalarını oluşturur, Fantom derleyicisi ile doğrular ve yolda bir Git yedekleme etiketi alır.
Eğer taşıma bozulursa, bir araç çağrısı ile geri alın. Tüm yolculuk diffable, tersine çevrilebilir ve anlatılabilir.
Bu Kimler İçin
- Uzantı yazarları SkySpark 3.x pod'larını 4.0'a taşıyan
- Haxall entegrasyonculuları Fantom'da bağlayıcılar, fonksiyonlar ve uygulamalar inşa eden
- SkySpark geliştiricileri Axon fonksiyonlarının grep yerine anlam ile aranabilir olmasını isteyenler
- AI destekli geliştiriciler doğru Fantom bağlamı gerektiren, halüsinasyon yapan söz dizimi değil
Taşıma Kokpiti
SkySpark 3'ü 4'e el kramplarısız taşıyın
Bir araç uzantınızı yeniden yazar. Başka bir araç onu işler. Üçüncü bir araç geri alır. Her değişiklik diffable'dır, derleyici doğrular, Git güvenlik ağını tutar.
fan compile tarafından doğrulanan çıkış. commitMigration çağrılıncaya kadar rollbackMigration aracılığıyla geri alma kullanılabilir.
Tembel İndeksleme
Sunucu, endeks tamamlanmadan önce cevap verir
Çoğu arama sunucusu, ilk önyüklemede müşteriyi 30 ile 60 saniye arasında endeksleme yaparken engeller. MCP Fantom bir saniyenin altında başlar. Araçlar hemen yanıt verir -- FlexSearch önce ısınır, yerel pod'lar daha sonra, gömülü hale getirmeler en son. Asistan hiçbir zaman beklemez.
Sorgular şeffaf şekilde düşer. Gömülü hale getirmeler hazır değilse, anlamsal araçlar anahtar sözcük aramasına geri döner. Asistan, zaman aşımı değil, sadakat hakkında bir not ile bir cevap alır.
Kod Zekası
Anlamsal anlayış, sadece metin eşleşmesi değil
semanticCodeSearch ve findSimilarCode Fantom kodunuzu bir vektör uzayına gömülü hale getirirler. "Birimleri normalleştiren işlevler" için sor ve yapıyı paylaşan, anahtar sözcükleri değil, sonuçları al.
Louvain kümeleme ile Graphology, kod tabanınızda doğal toplulukları bulur -- hangi türler birlikte asılı kalır, hangisi kalır. getCodeImpact bir değişikliğin nasıl yayıldığını izler. getCallers ve getCallees çağrı grafiği yüzeyini tamamlar.
Taşıma Güvenliği
Her taşıma bir geri alma uzakta
migrateSkySpark4x tek bir bayt yazılmadan önce bir Git etiketi oluşturur. Her şey başarısız olursa -- derleyici hatası, doğrulama uyuşmazlığı, sezginiz -- rollbackMigration depoyu çalıştırmanın önceki durumuna geri yükler.
commitMigration kasıtlıdır. Çıkışı kabul edene kadar hiçbir şey çalışma geçmişinize birleştirilmez. O zamana kadar, taşıma bir şubede yaşar, bir yedekleme etiketi ile, atılmaya hazır.
using yeniden yazmaları + Axon dönüştürme + Xeto üretimi.migrateSkySpark4x çağrılmadan önce.skyspark-4x-migration, connector-workflow ve xeto-spec-guide dahil.Rehberli İş Akışları
Araçların ötesinde -- okunabilir kılavuzlar
MCP kaynakları, asistanın talep üzerine okuyabileceği markdown belgeleridir. MCP Fantom on üçünü sevk eder: bir pod oluşturucusu, bir fanr yayınlama kılavuzu, bir Haxall uzantısı tanıtımı, bir fant birim testi primer, bir SkySpark 4.x taşıma oyun planı, bir Xeto spec kılavuzu ve daha fazlası.
Bir geliştirici "nasıl başlayabilirim?" diye sorduğunda, asistan doğru kaynağı çeker, özetler ve ilerler. Her iş akışı sunucu ile sürümlüdür.
- ✓ Adım adım markdown
- ✓
resources/listaracılığıyla keşfedilebilir - ✓ Sunucu ile sürümlü
- ✓ Daha fazlasını eklemek kolay
Sağlayıcı Yönlendirmesi
Sizin GPU, OpenRouter veya her ikisi aynı anda
Her çıkarım rolü kendi başına yönlendirilir. Gömülü hale getirme, yerel GPU'lar ve OpenRouter arasında bir kuyruktan çekerek fan out olabilir, yeniden sıralama yalnızca bulutta çalışır ve alma döngüsü şirket içinde kalır. Dört ilke, beş rol, rol başına ayarlanır ve çalışma zamanında değiştirilir.
OpenRouter'a işaret eden bir rol bir sanal kapsayıcı haline gelir: arkasında GPU ve VRAM olmayan gerçek hizmet kapasitesi, zamanlayıcının başka bir ana bilgisayar gibi iş vereceği kendi mantıksal sağlayıcı olarak kaydedilir. Yerel model yok, yerel donanım şartı yok -- MCP Fantom bir kod tabanını bir laptop'tan indeksler.
- ✓
aggregate-- bir fan-out havuzunda yerel ve bulut - ✓
backup-- ilk yerel, bulut yedekte tutulur - ✓
local-- hava boşluklu, ağdan hiçbir şey ayrılmaz - ✓
cloud-- yalnızca OpenRouter, GPU gerekmez
0.99 kosinüs içinde eşleşmeli, tam yapılandırılmış boyutta ve tek bir satır yazabilmesi için.
Teknoloji Yığını
Mimari
Yetenekler
- 41 MCP aracı -- belge araması, anlamsal kod araması, çağrı grafiği analizi, kod geçmişi, kod üretimi ve taşıma otomasyonunun tamamı
- Her role göre sağlayıcı yönlendirmesi --
code-embedding,embedding,reranker,code-assistantverlmher biri kendi ilkesini alır:local,cloud(yalnızca OpenRouter),aggregate(bir fan-out havuzunda her ikisi) veyabackup(yerel birinci, bulut yedekte tutulur) - Tembel indeksleme -- sunucu saniyeler içinde başlar ve hemen cevap verir; indeksleme arka planda çalışır ve araçlar bunu yaparken zarif bir şekilde öğrenir
- Anlamsal arama -- bir ANN indeksi arkasındaki LanceDB, isteğe bağlı çapraz kodlayıcı veya OpenRouter yeniden sıralayıcı ile
- Doğal dil S&C --
askCodebaseendeks üzerinde bir alma döngüsü çalıştırır ve alıntılanmış bir cevabı birleştirir - Gerçek bir çağrı grafiği --
getCallers,getCallees,getCodeImpactvegetCodeNeighborsgrep yerine gömülü bir grafik veritabanından yapısal soruların yanıtını verir - Axon desteği -- SkySpark Axon fonksiyonları, senkronize
proj/klasörlerinden veya çevrimdışı kütüphane dışa aktarımlarından, parçaların deyim sınırlarında yer alması vedefcomphücrelerinin bileşenin arayüzü olarak ortaya çıkması için amaçlı olarak oluşturulmuş bir tree-sitter dilbilgisi ile ayrıştırılmış - Geçmiş --
whatChangedRecently,getSymbolHistory,explainSymbolChangevediffIndexRunskodun bu şekilde nasıl hale geldiğinin yanıtını verir - SkySpark 4.x taşıması --
usingifadeleri ve Axon dizelerinin otomatik yeniden yazılması, Xeto dosyası üretimi (lib.trio,funcs.xeto,lib.xeto), derleyici doğrulaması, Git yedekleme etiketi, tek araç çağrısı geri alma - 13 iş akışı kaynağı --
create-pod'danskyspark-4x-migration'a kadar okunabilir markdown kılavuzları - Çift aktarım -- stdio ve HTTP, endeks kapsamı, gömülü hale getirme ilerleme durumu ve sağlayıcı yönlendirmesi için bir Next.js panosu ile
Ayakları Olmayan Bulut
Bir bulut gömülü hale getiriciyi yerel bir GPU'nun oluşturduğu bir endekse bırakmak, alımın sessizce çürümesi nedenidir -- kosinüs mesafesi karşılaştırılabilir olmaktan çıkar ve hiçbir şey size söylemez. MCP Fantom bunu bir uyarı yerine katı bir ön koşul olarak ele alır:
- Vektör uyumluluğu kapısı -- bir bulut sağlayıcısı, bir başvuru sağlayıcısının yanında sonda metinlerini gömülü hale getirir ve tek bir satır yazabilmesi için 0,99 minimum kosinüs, tam yapılandırılmış boyutta temizlemesi gerekir. Sorgu kodlayıcısı her zaman bu satırları oluşturan havuzdan gelir.
- Sabitlenmiş yukarı akışlar -- aynı model dilini hizmet eden iki OpenRouter ana bilgisayarı özdeş vektörleri garanti etmez, bu nedenle her gömülü hale getirme yolu, yukarı akışını adlandırmalıdır. Yeniden sıralama durumsuz ve sabitleme gerektirmez.
- Bir paylaşılan bütçe -- OpenRouter oran sınırlaması, arayanlar başına değil anahtar başına yapılır, bu nedenle tüm bulut eşzamanlılığı, ölçülen gecikme süresi tarafından Little Yasası'ndan boyutlandırılan tek bir global izin havuzundan çekilir. Bir 429, bütçeyi yarıya indirir ve sallamalı geri çekilir; yerel GPU'lar onu düz şekilde çalıştırır.
- Yalnızca yazma anahtarları -- API anahtarı, onu kullanan yan aracıya geçer. Hiçbir zaman yapılandırmaya yazılmaz, hiçbir zaman günlüğe kaydedilmez ve hiçbir uç nokta tarafından döndürülmez.
Araç Yüzeyi (Kısmi)
searchFantomCode, semanticCodeSearch, askCodebase, findSimilarCode, getFantomType, getFantomFunction, searchLocalDocs, searchVersionedApi, listFantomPods, getCallers, getCallees, getCodeImpact, getCodeNeighbors, whatChangedRecently, getSymbolHistory, explainSymbolChange, diffIndexRuns, axonSearch, axonFunction, generateFantomCode, migrateSkySpark4x, commitMigration, rollbackMigration, artı proje ve örnek yönetimi.
Gereksinimler
- Node.js 20+
- Bir gömülü hale getirme sağlayıcısı -- yerel bir model veya bir OpenRouter anahtarı
- Taşıma derleyici doğrulaması için yerel Fantom ve Haxall araç seti
- Taşıma yedeklemeleri için Git deposu
Bu projeyle ilgileniyor musunuz?
Kaynak kodunu keşfedin, katkıda bulunun veya iletişime geçin.