Ana içeriğe geç
Dil v0.2.0 · Ön izleme

Sınırlı N/M MCP tool'ları

Ajanları sıkı protokol uzlaştırması, kötü niyetli istemci doğrulaması, sınırlı taşıyıcılar ve Core/stdio davranış eşliğiyle sürümlü yerel N/M araçlarına bağlayın.

Herkese açık npm kurulumu

Yerel MCP sunucusunu bağlayın

Yerel stdio MCP sunucularını destekleyen bir istemci yapılandırın. Yerel araçlar verilen N/M kaynağını inceler ve çalıştırır; bu paket bir AI modeli veya barındırılan sohbet hizmeti değildir.

Node.js 20 veya üzeri gerekir. Yayın kontrollerinde Node.js 22.23.1 kullanılır.

npm paket sürümü 0.7.0, N/M dil sürümü 0.2.0'ı hedefler. Etiketsiz kurulum varsayılan latest kanalını seçer; aynı sürümü yeniden kurmak için @0.7.0 kullanın. Dağıtım kanalı, dilin preview olgunluk durumunu değiştirmez. VS Code eklentisinin dağıtım sürümü ayrıdır.

npm install --global @nm-lang/mcp

Bu sürümü sabitlemek için:

npm install --global @nm-lang/mcp@0.7.0

Sabit paket sürümü için MCP istemci yapılandırması

{
  "mcpServers": {
    "nm": {
      "command": "npx",
      "args": [
        "-y",
        "@nm-lang/mcp@0.7.0"
      ]
    }
  }
}

Örnekler yerel simülatörde çalışır. Kurulum fiziksel QPU erişimi sağlamaz veya bütün yetenekleri kararlı hâle getirmez.

Kişisel, eğitim ve ticari kullanım ücretsizdir. QuantumSoftware paket kodunun haklarını saklı tutar; değiştirme ve yeniden dağıtma için ayrıca izin gerekir. Kendi N/M programlarınız ve sonuçlarınız size aittir. Kurulan paketteki LICENSE.txt dosyasını okuyun.

Test raporları

0.3.0 ve üzeri sürümlerdeki nm_test, adlandırılmış testleri, özellik kontrollerini ve anlık görüntüleri Test Explorer 0.1 raporuyla çalıştırır. Verilen kodu ve modülleri kullanır, açık özellik izinlerini korur; kaynak gövdesini saklamadan konum ve özet değer döndürür. İsteğe bağlı uri yalnız kimlik etiketidir. Başarısız test, testsiz program veya yürütme hatasında isError döner.

Test yürütme sınırları

nm_test, çalıştırmadan önce olası genişletilmiş kontrol sayısını 1.000, ağırlıklı komut sayısını 4.096, yoğun durum işlem yükünü 16.777.216 birim ve snapshot genişliğini beş kübit ile sınırlar. Tahmin; dalları, döngüleri, otomatik ters işlemleri, örneklemeyi, gürültü yörüngelerini, eğitimi ve gradyanları kapsar. Raporda görselleştirme zaman çizelgesi ve ölçüm durum geçmişi tutulmaz; derse ait gizli challenge kontrolleri çalıştırılmaz. main erken döndüğü için hiç girilmeyen bir kontrol başarılı sayılamaz.

Çalıştırmadan önce işlem yükünü açıklama

@nm-lang/mcp 0.3.0 ve üzerinde nm_test için dryRun: true, simülasyon çalıştırmadan ayrı nm-mcp-work-budget 0.1 raporu döndürür. Normal test yanıtları da budget içerir. Rapor komut, kontrol, parser parametreleri, eğitim, gradyan, örnekleme ve gürültü etkenlerini açıklar. estimate.complete: false, sayımın yapısal sınırda durduğunu belirtir. Tahmin süre veya bellek garantisi vermez; geçersiz kaynakta bütçe yerine tanılar döner. Test Explorer 0.1 raporu aynı kalır.

İptal ve süre sınırı

Buradaki worker host, iptal ve başlangıç sınırları için @nm-lang/mcp 0.3.0 veya üzeri gerekir. Bağımsız stdio sunucusu araç çağrılarını ayrı Node worker'larında çalıştırır. Başlangıç seçenekleri --timeout-ms (varsayılan 15000, en fazla 30000), --max-concurrency (varsayılan 2, en fazla 4) ve --max-queue (varsayılan 8, en fazla 32) kabul edilen işleri sınırlar. Süre, kuyruk ve worker hazırlığını da kapsar. params.requestId içeren notifications/cancelled ilgili isteği durdurup NM-MCP-009 üretir; süre aşımı NM-MCP-010 döndürür. Bildirim kendi yanıtını üretmez. Sayısal/metin kimlikleri ayrıdır; yinelenen etkin kimlik id: null ile reddedilir. Yanıt sırası değişebilir. EOF kabul edilen işleri tamamlar; süreç sinyalleri worker'ları durdurur. Core'un eşzamanlı işleyicisi süre sınırı uygulamaz.

Sürümlü sınırlı MCP tool sözleşmesi

Core işleyicisi ve satırla ayrılan bağımsız stdio sunucusu ortak JSON-RPC yanıtları üretir. 0.3.0 ve üzeri sürümler sekiz yerel N/M aracını açmadan önce MCP protokolünü uzlaştırır.

2026-07-26
contract
2025-06-18
protocol
0.1
schema

Sürümlü tool şemaları

Her tool zorunlu alanları, kapalı ek özellikleri, sınırlı scalar aralıkları, davranış annotation'ları ve açık contract/schema sürümleri olan JSON Schema 2020-12 nesnesi yayımlar. Runtime doğrulaması UTF-8 byte ölçümünü de uygular.

Protokol yaşam döngüsü

Hosted oturumlar initialize öncesinde fail-closed davranır; desteklenmeyen protokol sürümünü ve yinelenen initialize'ı reddeder, initialized notification'ını kabul eder ve kararlı JSON-RPC ile NM-MCP hata kanıtı döndürür.

Yerel yürütme sınırı

Tool'lar ağa, kimlik bilgilerine, repository'lere veya keyfi dosyalara erişmez. Parse, simulation, training, export, optimization, örnek ve curated paket keşfi yalnız istek verisiyle paketli kayıtları kullanır.

Taşıyıcı sınırları

Büyük input satırları JSON dispatch öncesinde atılır. Kod, sorgu, structured tool verisi ve tam yanıtın bağımsız fail-closed bütçeleri vardır; output taşması kesilmiş veri yerine NM-MCP-007 üretir.

Ortak capability görünürlüğü

Ön izleme: Kullanılabilir bir ön izlemedir, kararlı uyumluluk taahhüdü değildir; production kullanımından önce listelenen sınırlamaları inceleyin. Deneysel sözleşmeler kararlı sürümün uyumluluk taahhüdü olmadan değişebilir. Yeni oturumlarda varsayılan dil profili açıktır; diğer özellikler ayrıca açılır. Kayıtlı ayarlar korunur.

Yerel simülatör sonucu

Yalnız yerel veya sentetik yürütmedir; bu sonuç fiziksel cihaz performansı ya da quantum advantage kanıtı değildir. Açık bir provider/cihaz yolu ve saklanan backend provenance kanıtı gerekir; simülatör çıktısı hiçbir zaman donanım kanıtına dönüşmez.

1 MB
input satırı
200 KB
kod
256 B
sorgu
400 KB
tool verisi
2 MB
yanıt

JSON-RPC / stdio

npm run nm:mcp

{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18" } }
nm_parsenm_runnm_trainnm_exportnm_import_irnm_optimizenm_examplesnm_testnm_capabilities
NM-MCP-001NM-MCP-002NM-MCP-003NM-MCP-004NM-MCP-005NM-MCP-006NM-MCP-007NM-MCP-008NM-MCP-009NM-MCP-010

Yerel sözleşme satırla ayrılan stdio ile sürümlü araç şemalarını kapsar. Uzak taşıma, prompt/resource, sampling, sunucuda kalıcılık, sırlar, keyfi dosya sistemi erişimi ve üçüncü taraf MCP istemci sertifikasyonu bu adayın dışındadır.