Genel Bakış

Axon MCP Server'ın ne yaptığı, neden var olduğu ve onunla neler yapabileceğiniz.

Ne olduğu

Axon MCP Server, yapay zeka asistanlarına bir Axon kod tabanına uzman düzeyinde erişim sağlayan bir Model Context Protocol sunucusudur. Axon kaynak dosyalarını ve HTML belgelerini indeksler, MCP üzerinden arama ve kod oluşturma araçlarını sunar ve canlı bir SkySpark örneğine karşı sorgular yürütebilir.

Axon, bina otomasyonu, HVAC denetimi ve enerji yönetimi için SkySpark'ın alana özgü dilidir. MCP sunucusu, bir Axon kod klasörünü, MCP uyumlu herhangi bir istemci (Claude Desktop, Cursor, MCP CLI) tarafından sorgulanabilen yapılandırılmış bir bilgi tabanına dönüştürür.

Bununla neler yapabilirsiniz

  • Axon kodu ve belgelerde arama yapın — alaka düzeyi puanlaması, operatör düzeyinde sorgular ve regex desenleri ile FlexSearch destekli tam metin araması.
  • Yeni Axon kodu oluşturun — yaygın HVAC, enerji, hata ve veri iş akışları için 33 hazırlanmış YAML şablonu. Oluşturulan kod, döndürülmeden önce anlamsal olarak doğrulanır.
  • Canlı bir SkySpark örneğine karşı kod yürütün — Haystack sorgularını çalıştırın, Axon ifadelerini değerlendirin ve otomatik sürümlendirme ile işlevleri kaydedin.
  • Çağrı grafiklerini analiz edin — çağıranları ve çağrılan işlevleri bulun, döngüsel bağımlılıkları tespit edin, en çok çağrılan veya en karmaşık işlevleri tanımlayın.
  • Vektör gömmelerle anlam tabanlı arama — anahtar kelime eşleşmesinden ziyade anlama göre kod döndüren doğal dil sorguları.

Nasıl bir araya geldiği

┌──────────────────┐     MCP       ┌──────────────────────┐      HTTP    ┌────────────┐
│ AI client        │ ─────────────▶│ Axon MCP Server      │ ────────────▶│ SkySpark   │
│ (Claude, Cursor) │               │  • search index      │              │ (Haystack) │
│                  │               │  • code generator    │              └────────────┘
│                  │ ◀─────────────│  • graph analyser    │
└──────────────────┘    results    │  • OAuth 2.1         │
                                    └──────────────────────┘
                                              │
                                              ▼
                                       .axon / .trio files
                                       HTML documentation

Bağlantılar stdio (sunucuyu bir alt işlem olarak oluşturan yerel yapay zeka istemcileri için) veya http (OAuth'nin arkasındaki uzak istemciler için) üzerinden çalışır. /admin adresindeki pano, oturumlar ve kullanıcı yönetimi için bir web arayüzü sağlar.

Ana özellikler

  • Hızlı arama — binlerce HTML dosyası arasında ~50 ms tam metin; ilk indeksleme 30-60 s alır ve önbelleğe alınır.
  • PKCE ile OAuth 2.1 — çok kullanıcılı kimlik doğrulaması, kapsamlı belirteçler (mcp:read, mcp:write, mcp:admin).
  • İşlev sürümlendirmesi — sunucu aracılığıyla kaydedilen her işlevin son 4 revizyonunu otomatik olarak saklar.
  • Otomatik bulma — bir SkySpark örneğini yapılandırın; sunucu projeleri numaralandırır ve işlevlerini otomatik olarak senkronize eder.
  • Yerel SQLite kalıcılığı — kullanıcı deposu, yedekleme bildirimleri ve grafik metrikleri Prisma aracılığıyla tek bir dosyada yaşar.

Proje durumu

Sunucu aktif geliştirme aşamasındadır ve arama, yürütme ve kod oluşturma iş akışları için kararlı kabul edilir. Lisans: ISC. Sorunlar ve katkılar GitHub üzerinde memnuniyetle karşılanır.