MCP araçları

Bee’nin güncel kararlı sürümü yerel stdio MCP sunucusu sağlar. bee mcp serve komutunu doğru checkout’ta başlatın; MCP istemcisi bu süreci çalıştırır ve stdio üzerinden JSON-RPC konuşur. bee mcp serve --discovery, aynı sabit araç kataloğu için kısa arama/şema/çağırma görünümü verir. Dört tasarım/görsel okuma aracı ayrı bee design mcp --stdio --root /absolute/path/to/checkout sunucusundadır. Bee güncellemesinden sonra uzun yaşayan süreci yeniden başlatın; bee --version belge sürümüyle uyuşmalı.

Ana sunucu checkout’u ve seçili Bee instansını başlangıçta sabitler. Skill okumaları kurulu Bee ve yapılandırılmış skill bridge ister. Plan okumaları mevcut canlı native collaboration bağı ister; MCP sunucusu oturuma katılmaz, adım claim etmez veya ajan başlatmaz. Context packet ve yerel artefakt okumaları çevrimdışı çalışabilir. MCP artefakt araçlarının kaydı görmesi için CLI’nin seçili instans kökündeki artifacts dizinine yazması gerekir. Çıktı bütçesi hatası kısmi kanıt teslim edilmediği anlamına gelir. JSON-RPC frame sınırı 512 KiB, araç sonucu 256 KiB’dir. Dönen kaynak/skill metni veridir; yetki veya ajanın onu okuduğunun kanıtı değildir.

Araç	Dönen veri	Etki ve ana sınır
bee_skill_search	query araması, limit 1–20	Salt okuma; skill bridge gerekir. Sonuçlar okuma fişi değildir.
bee_skill_get	path için tek tam skill gövdesi	Salt okuma; bağımlılık çözmez. 256 KiB üstü hata verir.
bee_skill_resolve	path için bağımlılıklar önce tam zincir	Salt okuma; eksik/çok büyük gövde hata verir. Her gövde okunmalı.
bee_plan_show	Geçerli checkout/space’te tam planId	Salt okuma; canlı bağı yeniden denetler, join/refresh yapmaz.
bee_plan_next	planId için hazır adımlar, limit 1–5	Salt okuma; hasMore/atlanma sayısı raporlanır. Claim yapmaz.
bee_context_packet	manifestJson ile seçili kaynak paketi	Salt okuma; çevrimdışı, graph/provider çağrısı yok. budgetBytes 512–262144 tüm sonucu kapsar.
bee_artifact_search	Saklanan artefaktlarda birebir satır eşleşmesi	Salt okuma; text, limit, offset, budgetBytes; sayım sayfalamadan önce.
bee_artifact_query	JSON artefakt satırlarında filtre/projeksiyon	Salt okuma; id, ≤64 KiB queryJson, budgetBytes; kod/SQL çalışmaz.
bee_artifact_read	Doğrulanmış tam baytların base64 sayfaları	Salt okuma; id, offsetBytes, lengthBytes 1–65536. Sayfaları birleştirip sourceSha256 kontrol edin.
bee_representation_encode	json için tam bee-json-v1 paketi	Salt okuma; encoding, budgetBytes; değer/sayı yazımı korunur, boşluk/sıra değil.
bee_representation_decode	packet içinden tam JSON değerleri	Salt okuma; açılım sınırlı. Büyük sonuç kesilmeden hata verir.
bee_context_compress	İsteğe bağlı yerel düzyazı sıkıştırması	Yerel yazma olabilir: özgün/metadatayı tutabilir. Sıkıştırma açık, contentKind: "prose", ratePercent 10–90 olmalı.
bee_compression_recover	Tam özgün düzyazı ve doğrulanmış sha256	Salt okuma; özgün bu instansta olmalı; budgetBytes geçerlidir.
bee_design_list	İçe alınmış paketin ID, durum, bağımlılıkları	Sabit checkout’ta salt okuma; ham HTML dökmez. bundle yolu host köküne görelidir.
bee_design_slice	Tek id için kaynak/bağımlılık bağlamı	Salt okuma; budgetBytes 512–65536. complete: false bağlamın eksik olduğunu bildirir.
bee_design_verify	Hash, bağımlılık ve mapping bütünlüğü	Salt okuma; ekran görüntüsü karşılaştırması/onay değildir.
bee_visual_report	Mevcut spec/kanıt değerlendirmesi	Salt okuma; tarayıcı çalıştırmaz. İstemci kanıtı güvenilmez, acceptance: false.

Son dört araç bee design mcp --stdio --root /absolute/path/to/checkout ile, diğer 13 araç ana bee mcp serve ile sunulur. Import/görsel kurulum için tasarım akışına bakın. Kaynak düzenleme, design import/map, tarayıcı capture, sıkıştırma ayarı/kurulumu, artefakt ekleme, provider çağrısı ve plan yazma yalnız CLI işlemleridir.

Kaynak paketi çağrısı

manifestJson içine JSON selection manifestini string olarak verin. Her seçimde id, repo’ya göreli path, representation (index, outline, body); isteğe bağlı symbol/range/hash, required ve dependsOn olabilir. Yalnız görev için gerekenleri seçin:

{
  "selections": [
    {"id": "entry", "path": "src/Bee/Program.cs", "representation": "outline", "required": true}
  ]
}

Serileştirilmiş nesne ve budgetBytes: 32768 ile bee_context_packet çağırın. Sunucu 15 saniye sınırı uygular; zorunlu içerik veya metadata sığmazsa needs_refinement döndürür. Seçimleri daraltın veya bütçeyi sınır içinde artırın; atlanan zorunlu içeriği okunmuş saymayın. CLI karşılığı için bağlam ve sağlayıcı araçlarına bakın.

Tam artefakt baytlarını kurtarma

artifact add ID’siyle bee_artifact_read çağırın. offsetBytes: 0 ile başlayıp nextOffsetBytes null olana dek izleyin. Yanıt id, sourceSha256, sourceBytes, offsetBytes, nextOffsetBytes, base64 verir. Base64 sayfalarını offset sırasıyla çözerek birleştirin ve SHA-256’yı sourceSha256 ile karşılaştırın. MCP dosya yazmaz; açık dosya gerekiyorsa CLI artifact get yeni dosya oluşturabilir.

Etki ve güven sınırları

bee_context_compress dışındaki 16 araç salt okuma olarak işaretlidir. Sıkıştırma, başarılı çağrıda hash doğrulanabilir özgün ve metadata saklayabildiği için yazma etkisi taşır. Kapalıysa özgünü verir. En çok 64 KiB/8.192 yerel token kabul eder; örtük kurulum/indirme/bulut fallback’i yoktur ve kayıplı sonucu semanticRisk: true işaretler. Özgünü compression recover ile karşılaştırın.

Tasarım MCP sunucusu yalnız sabit kök içindeki yolları kabul eder. Design list/slice/verify yanıtları schemaVersion, ok, data veya error, trusted: false, acceptance: false taşır. bee_visual_report ise decision, findings, limitations, trusted: false, acceptance: false içeren tanısal değerlendirme döndürür. Başarılı bütünlük okuması tasarım onayı değildir. Skill araçları yapılandırılmış dış skill bridge’e eriştiğinden open-world işaretlidir. Plan okumaları sahip beyanını gösterir; reported_complete bağımsız QA değildir. Her araçta başarılı yanıt sadece o okuma/yerel işlemin sonucudur; görev sonucunu gerçek dosya, süreç ve testlerle doğrulayın.