MCP tööriistad

Bee praegune stabiilne väljalase pakub kohalikku stdio MCP serverit. Käivita bee mcp serve õiges checkout’is; MCP klient alustab protsessi ja vahetab JSON-RPC-d stdio kaudu. bee mcp serve --discovery annab sama fikseeritud kataloogi jaoks kompaktse otsingu/skeemi/kutse vaate. Neli disaini/visuaali lugemist on eraldi bee design mcp --stdio --root /absolute/path/to/checkout hostis. Pärast Bee uuendamist käivita pikaealine server uuesti; bee --version peaks vastama dokumendi versioonile.

Põhihost fikseerib käivitamisel checkout’i ja valitud Bee instantsi. Oskuste lugemine vajab initsialiseeritud Bee’d ja seadistatud skill bridge’i. Plaani lugemine vajab olemasolevat aktiivset native-koostööseost; MCP host ei liitu, ei võta sammu ega käivita agenti. Kontekstipaketid ja kohalikud artefaktilugemised võivad toimida võrguühenduseta. MCP artefaktitööriistade jaoks peab CLI kirjutama valitud instantsi juure artifacts kataloogi. Väljundieelarve viga tähendab, et osalisi tõendeid ei väljastatud. JSON-RPC kaadri piir on 512 KiB ja tööriistatulemuse piir 256 KiB. Tagastatud lähte- või oskustekst on andmed, mitte volitus ega tõend lugemisest.

Tööriist	Tulemus	Mõju ja põhipiirang
bee_skill_search	Pakkuja vasted query järgi, limit 1–20	Ainult lugemine; bridge vajalik. Vasted pole lugemisreceipt’id.
bee_skill_get	Üks täielik oskuse tekst path järgi	Ainult lugemine; eeltingimusi ei lahenda. Üle 256 KiB annab vea.
bee_skill_resolve	Täielik, sõltuvused enne, ahel path järgi	Ainult lugemine; puuduv/ülemõõduline sisu annab vea. Loe kõik kehad.
bee_plan_show	Täpne planId praeguses checkout’is/ruumis	Ainult lugemine; kontrollib aktiivset seost uuesti, ei liitu/uuenda.
bee_plan_next	Valmis sammud planId jaoks, limit 1–5	Ainult lugemine; hasMore/väljajätmiste arv näitab piirangut. Ei claim’i sammu.
bee_context_packet	manifestJson-iga valitud lähtepakett	Ainult lugemine; offline, graafi/pakkuja kutset pole. budgetBytes 512–262144 katab kogu tulemuse.
bee_artifact_search	Säilitatud artefaktide sõnasõnalised reavasted	Ainult lugemine; text, limit, offset, budgetBytes; loendus enne lehekülgi.
bee_artifact_query	Filtreeritud/projitseeritud JSON-read	Ainult lugemine; id, kuni 64 KiB queryJson, budgetBytes; koodi/SQL-i ei käivitata.
bee_artifact_read	Kontrollitud täpsete baitide base64-lehed	Ainult lugemine; id, offsetBytes, lengthBytes 1–65536. Ühenda ja kontrolli sourceSha256.
bee_representation_encode	Täielik bee-json-v1 pakett json jaoks	Ainult lugemine; encoding, budgetBytes; väärtused/arvukujud säilivad, tühikud/järjekord mitte.
bee_representation_decode	Täielikud JSON-väärtused packet-ist	Ainult lugemine; piiratud avamine. Liiga suur tulemus annab vea, mitte kärpe.
bee_context_compress	Valikuline kohalik proosatihendus	Võib kirjutada kohapeal: võib säilitada algteksti/metaandmed. Tihendus peab olema sees, contentKind: "prose", ratePercent 10–90.
bee_compression_recover	Täpne algtekst ja kontrollitud sha256	Ainult lugemine; algtekst peab olema selles instantsis; budgetBytes kehtib.
bee_design_list	Imporditud paketi ID-d, olekud ja sõltuvused	Ainult lugemine fikseeritud checkout’is; toorest HTML-i ei tagasta. bundle tee hosti juure suhtes.
bee_design_slice	Ühe id lähte-/sõltuvuskontekst	Ainult lugemine; budgetBytes 512–65536. complete: false tähendab puudulikku teostuskonteksti.
bee_design_verify	Räsi, sõltuvuste ja mapping’u terviklus	Ainult lugemine; pole ekraanipildi võrdlus ega disaini heakskiit.
bee_visual_report	Olemasoleva spetsifikatsiooni/tõendi hinnang	Ainult lugemine; brauserit ei käivita. Kutsuja tõend on usaldamata, acceptance: false.

Viimased neli on bee design mcp --stdio --root /absolute/path/to/checkout hostis, ülejäänud 13 põhihostis bee mcp serve. Impordi ja visuaali seadistuseks vaata disaini töövoogu. Lähtefailide muutmine, design import/map, brauseri pildistamine, tihenduse seadistus/paigaldus, artefakti lisamine, mudelikutse ja plaani kirjutamine on ainult CLI toimingud.

Lähtepaketi kutse

Anna JSON-valikumandifest stringina manifestJson argumendis. Igal valikul on id, repo suhteline path, representation (index, outline või body) ning valikulised symbol/range/hash, required ja dependsOn. Vali ainult ülesandeks vajalik:

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

Kutsu bee_context_packet selle serialiseeritud objektiga ja budgetBytes: 32768. Host kasutab 15-sekundilist tähtaega ning tagastab needs_refinement, kui kohustuslik sisu või metaandmed ei mahu. Kitsenda valikuid või tõsta eelarvet lubatud piires; väljajäetud kohustuslik sisu pole loetud. Vastav CLI on konteksti ja pakkujate tööriistades.

Täpsete artefaktibaitide taastamine

Kutsu bee_artifact_read artifact add tagastatud id väärtusega. Alusta offsetBytes: 0 ja järgi nextOffsetBytes kuni null. Igas vastuses on id, sourceSha256, sourceBytes, offsetBytes, nextOffsetBytes ja base64. Dekodeeri ja ühenda lehed offset’i järjekorras, seejärel võrdle SHA-256 väärtust sourceSha256-ga. MCP ei kirjuta faili; selgesõnalise failitaaste jaoks kasuta CLI artifact get.

Mõju ja usalduse piirid

Kõik peale bee_context_compress on märgitud ainult lugemiseks: kokku 16 tööriista. Tihendus võib edukal kutsel salvestada kontrollitava algteksti ja kohalikke metaandmeid, mistõttu sellel on kirjutamismõju. Väljas olles tagastab see algteksti. Piir on 64 KiB/8192 kohalikku tokenit; varjatud seadistust/allalaadimist/pilvefallback’i pole ning kadudega väljund kannab alati semanticRisk: true. Võrdle algtekstiga compression recover kaudu.

Disaini MCP host lubab vaid oma fikseeritud juure sees olevaid teid. Design list/slice/verify vastused sisaldavad schemaVersion, ok, data või error, trusted: false ja acceptance: false. bee_visual_report tagastab hoopis diagnostilise hinnangu väljadega decision, findings, limitations, trusted: false, acceptance: false. Edukas tervikluse lugemine pole heakskiit. Oskusetööriistad loevad seadistatud välisest bridge’ist ja on seetõttu open-world. Plaanilugemine näitab omaniku raporteeritud olekut; reported_complete pole sõltumatu QA. Edukas tööriistakutse tõendab vaid selle lugemise/kohaliku toimingu tulemust; kontrolli töö tegelike failide, protsessi ja testidega.