majordomus mcp
Zpřístupnit AI vrstvu repozitáře klientovi MCP přes stdio
majordomus mcp
Použití
majordomus mcp [OPTIONS]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --repo | <PATH> | — | Zde začne hledání kořene repozitáře (výchozí: aktuální adresář) (přijímá každý podpříkaz) |
| --discovery | vcs | filesystem | vcs | Jak se vyhledávají deklarativní soubory (přijímá každý podpříkaz)
|
| --strict | flag | — | Odmítne pokračovat, pokud kterýkoli soubor vrstvy nese diagnostiku typu chyba (přijímá každý podpříkaz) |
| --share | <DIR> | — | Adresář share distribuce nástroje (kinds.yaml, schemas/); výchozí: $MAJORDOMUS_SHARE, poté vlastní share/ repozitáře, poté ten vedle spustitelného souboru (přijímá každý podpříkaz) |
| --inspect | flag | — | Vypsat, co by se poskytovalo, a každou diagnostiku, a skončit bez obsluhy |
| --format | text | json | text | Tvar výstupu --inspect
|
| --transport | stdio | stdio | Transport, na kterém obsluhovat
|
| --standalone | flag | — | Obsluhovat jen tohoto klienta: žádný sdílený server, žádné HTTP, žádné Swagger UI, žádní peeři a nic se nikam nezapisuje. Výchozí je sdílený server (níže) |
| --http-host | <HOST> | — | Rozhraní, na kterém sdílený server naslouchá, když ho spouští tento proces; bez něj to, které pojmenovává `MAJORDOMUS_HTTP_HOST` na tomto stroji, a loopback (`127.0.0.1`), když není nastaveno |
| --http-port | <PORT> | — | Port, na kterém sdílený server naslouchá, když ho spouští tento proces; bez něj port, který odvodí tento checkout (8741 pro primární checkout). Když je obsazen, použije se místo něj volný port a URL se v obou případech zaloguje na stderr |
Příklady
-
Podívejte se, co by se obsluhovalo, aniž by se obsluhovalo
Sestaví registr a index repozitáře v pracovním adresáři, vypíše repozitář, schopnosti, objekty a každou diagnostiku a skončí. Nic se neservíruje a nic se nezapisuje.
$ majordomus mcp --inspectCo tvrdí: skončí s kódem 0; vypíše repository, capabilities.
Testuje apps/majordomus-cli/tests/cli_examples.rs, který spouští příkaz nad sestaveným programem a ověřuje, co stránka uvádí.
-
Totéž jako jeden dokument JSON pro skript
Tvar, který `--inspect` vypisuje pro člověka, jako JSON: repozitář, jeho režim objevování, schopnosti a diagnostiky, deterministický a bezpečný k porovnání diffem.
$ majordomus mcp --inspect --format jsonCo tvrdí: skončí kódem 0; vypíše jeden dokument JSON nesoucí /repository/repository/root, /tools.
Testuje apps/majordomus-cli/tests/cli_examples.rs, který spouští příkaz nad sestaveným programem a ověřuje, co stránka uvádí.
-
Obsluhovat jednoho klienta MCP přes stdio
Podoba, kterou spouští klient MCP: rámce JSON-RPC na stdin, rámce ven na stdout, logy na stderr a relace končí koncem vstupu. `--standalone` nechá tento proces jen pro sebe: žádný sdílený server, žádné HTTP, nic se nikam nezapisuje.
$ majordomus mcp --standaloneCo tvrdí: odpovídá na initialize a tools/list na stdio a na konci vstupu skončí kódem 0.
Testuje apps/majordomus-cli/tests/cli_examples.rs, který spouští příkaz nad sestaveným programem a ověřuje, co stránka uvádí.
Odkud to pochází
Deklarováno jednou v apps/majordomus-cli/src/cli.rs: clap pro strukturu, typovaná metadata v Rustu vedle něj pro příklady. Tato stránka, majordomus mcp --help, docs/generated/cli.md a docs/generated/cli.json jsou projekce této jediné deklarace.
Celá příkazová řádka na jedné stránce: stránka příkazové řádky registru. Životní cyklus úlohy (init, start, finish, doctor, ...) patří nástroji shell, jinému programu: Příkazy a jeho specifikace.