MCP nástroje, prompty a zdroje
Server: kontext mcp – JSON-RPC 2.0 cez stdio, správy oddelené novým riadkom. Verzie protokolu 2024-11-05, 2025-03-26, 2025-06-18 a 2025-11-25 (verzia klienta sa zopakuje, ak je podporovaná). Schopnosti: tools, prompts, resources, logging. Výsledky nástrojov sú text; chyby sa vracajú ako výsledky s isError: true.
Nástroje
Každý nástroj nesie MCP anotácie, podľa ktorých klienti rozhodujú, čo treba schváliť: ctx_brief, ctx_search, ctx_read, ctx_why a ctx_log majú readOnlyHint: true; ctx_capture, ctx_inbox, ctx_prepare_commit, ctx_init a ctx_init_submit zapisujú len do lokálneho inboxu, pracovného stromu a git indexu a majú destructiveHint: false. Všetky majú openWorldHint: false.
ctx_brief
| Parameter | Typ | Predvolene | |
|---|---|---|---|
focus | string[] | cesty alebo slová k téme, ktoré sa uprednostnia | |
budget_tokens | integer | brief.budget_tokens (1400) | približná veľkosť |
adapters | boolean | true | zahrnie sekcie brief z adaptérov |
ctx_search
| Parameter | Typ | Predvolene | |
|---|---|---|---|
query | string | povinné | slová, identifikátory, cesty |
kinds | string[] | decision, convention, learning, incident, architecture, doc, commit | |
sources | string[] | všetky | local a/alebo názvy adaptérov |
limit | integer | 10 | najviac výsledkov (do 50) |
budget_tokens | integer | 1200 | približná veľkosť odpovede |
Každý výsledok: N. title — snippet [kind · status · date · source] <uri>.
ctx_read
| Parameter | Typ | Predvolene | |
|---|---|---|---|
uri | string | povinné | kx:<id>, file:<path>[#section], git:<sha>, inbox:<id>, URI adaptéra alebo obyčajná cesta |
level | 0 | 1 | 2 | 1 | jeden riadok, prehľad, celé |
ctx_why
| Parameter | Typ | Predvolene | |
|---|---|---|---|
target | string | povinné | cesta, path:line, path:start-end, SHA commitu alebo symbol |
limit | integer | 12 | položiek na sekciu |
ctx_log
| Parameter | Typ | Predvolene | |
|---|---|---|---|
kind | string | decision | druh, ktorý sa vypíše |
all | boolean | false | zahrnie nahradené / zamietnuté |
limit | integer | 40 | riadky |
ctx_capture
| Parameter | Typ | Predvolene | |
|---|---|---|---|
kind | string | povinné | decision, convention, learning, incident (akceptujú sa aliasy) |
title | string | povinné | krátke tvrdenie |
body | string | povinné | Markdown: kontext, rozhodnutie alebo poznatok, dôsledky |
summary | string | jeden riadok | |
paths | string[] | cesty alebo globy, ktorých sa týka | |
tags | string[] | ||
visibility | team | private | capture.default_visibility | |
supersedes | string[] | ID záznamov, ktoré nahrádza | |
status | string | accepted pri rozhodnutiach | |
promote | boolean | false | zapíše ho hneď do úložiska namiesto inboxu |
ctx_inbox
| Parameter | Typ | Predvolene | |
|---|---|---|---|
action | list | show | promote | drop | list | |
ids | string[] | pre show / promote / drop |
ctx_prepare_commit
| Parameter | Typ | |
|---|---|---|
promote | string[] | ID z inboxu, ktoré sa zapíšu do úložiska a stagnú |
drop | string[] | ID z inboxu, ktoré sa zahodia |
Vráti report opísaný v Zachytávanie a review.
ctx_init
| Parameter | Typ | Predvolene | |
|---|---|---|---|
count | integer | 1 | koľko úloh vrátiť (do 5) |
bootstrap | boolean | false | založí úložisko znalostí, keď ho repozitár nemá – len keď o to požiadal používateľ |
Keď repozitár ešte nemá .ai/ a bootstrap je true, ctx_init najprv spustí scan, history a render (bez hookov) a potom vráti prvú úlohu; bez neho vysvetlí, ako kontext zaviesť. Vetvu nikdy nezavádza, keď tímové znalosti už má iná vetva.
V repozitári bez úložiska znalostí prijme ctx_capture len visibility: private a ctx_inbox / ctx_prepare_commit nepovyšujú.
ctx_init_submit
| Parameter | Typ | |
|---|---|---|
task_id | string (povinné) | purpose, mod:<module>, dec:<area>, refresh:<module> |
summary | string | jeden riadok, najviac ~200 znakov |
overview | string | Markdown, 5–15 riadkov |
decisions | object[] | {title, decision, summary?, context?, consequences?, paths?, commits?, date?, status?, tags?} – pre úlohy dec: |
learnings | object[] | {title, body, paths?, tags?} |
skip | boolean | preskočí úlohu |
reason | string | prečo sa preskakuje |
paths, commits a tags prijímajú aj reťazce oddelené čiarkou.
Nástroje adaptérov
Nástroje MCP adaptérov s expose sa vypisujú s ich pôvodnými schémami (názvy s prefixom <adapter>_, ak ním už nezačínajú); nástroje deklarované v konfigurácii adaptéra sa vypisujú so schémou z params. Ich popisy začínajú [adapter].
Prompty
| Názov | Argumenty | Účel |
|---|---|---|
kontext-init | tasks (voliteľné) | zavedie a prehĺbi znalosti repozitára |
kontext-commit | pripraví aktuálnu zmenu na commit | |
kontext-reflect | zachytí zo session najviac tri trvalé veci |
Zdroje
| URI | Obsah |
|---|---|
kontext://brief | brief (bez sekcií adaptérov) |
kontext://entry/<id> | Markdown záznamu (šablóna kontext://entry/{id}) |
Požiadavky iniciované serverom
MCP klient vnútri kontextu (používajú ho adaptéry mcp) odpovedá serverom, ktoré spúšťa, na ping a roots/list (s koreňom repozitára); ostatné požiadavky serverov odmietne.