serve
/serve
Podłącza skompilowany potok rote jako narzędzie MCP, aby Claude mógł bezpośrednio uruchamiać wdrożony przepływ, z poleceniami rote register, rote serve i claude mcp add.
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 3
Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Podłącza skompilowany potok rote jako narzędzie MCP, aby Claude mógł bezpośrednio uruchamiać wdrożony przepływ, z poleceniami rote register, rote serve i claude mcp add.
Wyzwalacze z opisu
Oryginalny opis (EN)
Wire a compiled rote pipeline up as an MCP tool so Claude can trigger the deployed workflow directly. Use when the user says "register my compiled pipeline", "serve my pipelines over MCP", "trigger the workflow from Claude", "hook the pipeline up to Claude", or asks what to do after `rote compile` and deployment. Covers `rote register` and `rote serve` plus the `claude mcp add` wiring.
Jak działa
- 1. Check preconditions
- 2. Register the pipeline
- 3. Add the MCP server to Claude
- 4. Explain the reconnect caveat
Podgląd SKILL.md
---
name: serve
description: >-
Wire a compiled rote pipeline up as an MCP tool so Claude can trigger the
deployed workflow directly. Use when the user says "register my compiled
pipeline", "serve my pipelines over MCP", "trigger the workflow from
Claude", "hook the pipeline up to Claude", or asks what to do after
`rote compile` and deployment. Covers `rote register` and `rote serve`
plus the `claude mcp add` wiring.
---
# Serve compiled pipelines as MCP tools
`rote serve` is one MCP server exposing every registered pipeline as a
callable tool. The flow:
```
rote compile → deploy the runtime → rote register → rote serve → call from Claude
```
`rote serve` **triggers deployed workflows; it does not host them.**
MCP triggering supports the `dbos` (default), `temporal`, and
`cloudflare` runtimes.
The CLI ships on PyPI as `rote-cli` with an executable named `rote`,
so every invocation is `uvx --from rote-cli rote <args>` (never
`uvx rote-cli ...`). For unreleased features, substitute the source:
`uvx --from git+https://github.com/trevhud/rote rote <args>`.
## 1. Check preconditions
- A compile output directory exists (contains `compiled/pipeline.yaml`).
- The runtime side is running: for DBOS, the emitted app in worker mode
(`python main.py --serve` or `dbos start`) against the system
database you'll register — enqueued runs sit in status `enqueued`
until that process exists; for Temporal, a worker against the user's
cluster; for Cloudflare, `wrangler deploy` done. If not, stop and
help with that first.
## 2. Register the pipeline
```sh
# DBOS (the default). System DB URL: --system-database-url, else
# $DBOS_SYSTEM_DATABASE_URL, else the emitted app's SQLite file
# (derived from <out-dir>/runtime/dbos/main.py).
uvx --from rote-cli rote register <out-dir>
# Temporal (defaults: localhost:7233, namespace "default",
# task queue = pipeline.name, workflow type = the emitted versioned name)
uvx --from rote-cli rote register <out-dir> --runtime temporal
# Cloudflare
uvx --from rote-cli rote register <out-dir> --runtime cloudflare \
--url https://<worker>.workers.dev
```
This upserts `~/.rote/registry.json`. Re-registering updates in place.
**After re-compiling a changed skill, register again** — the DBOS and
Temporal workflow names are derived from the pipeline content hash and
must stay in sync with the emitted code.
## 3. Add the MCP server to Claude
`rote serve` needs the `serve` extra (FastMCP) plus `dbos` when any
registered pipeline runs on DBOS, so the spec includes both:
```sh
claude mcp add --scope user rote -- uvx --from 'rote-cli[serve,dbos]' rote serve
```
For unreleased features, use the GitHub source instead:
```sh
claude mcp add --scope user rote -- \
uvx --from 'rote-cli[serve,dbos] @ git+https://github.com/trevhud/rote' rote serve
```
Verify with `claude mcp list`. Each registry entry becomes two tools
(three for DBOS): `<name>` (starts a run, returns `{workflow_id,
status: "started"}` immediately — compiled pipelines run minutes to
days), `<name>_status` (polls a run by `workflow_id`), and for DBOS
`<name>_signal` (resumes a run parked at a HITL gate: `workflow_id` +
gate signal name + resume payload — so Claude can deliver approvals
itself). A DBOS run whose status stays `enqueued` means the emitted app
process isn't running against the registered system database.
Two built-in tools are always there, even before anything is
registered: `rote_list_pipelines` (every registered pipeline, its
runtime, and its tool names, with an optional `runtime` filter) and
`rote_describe_pipeline` (one pipeline's input schema and trigger
config, passwords redacted). Call `rote_list_pipelines` first when the
user asks what is available. The `rote_` prefix is reserved for them,
so `rote register --name` refuses names that start with it.
## 4. Explain the reconnect caveat
A running `rote serve` picks up registry changes live — no restart of
the server, ever. But clients differ:
- **Claude Code** refreshes its tool list on the server's
`list_changed` notification: newly registered pipelines appear
immediately.
- **Claude Desktop and claude.ai** snapshot tools at connect time. A
pipeline registered while they're connected appears only after a
reconnect — restart Desktop or toggle the server off/on; on
claude.ai, re-enable the connector.
Tell the user this proactively if they plan to use Desktop or claude.ai.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · trevhud/rote | 100 | Apache-2.0 |
| ccplugins/awesome-claude-code-plugins | 100 | Apache-2.0 |
| tomascupr/sous-chef | 100 | MIT |
| pavelvod/lantern | 91 | MIT |
| clockgrove/factory | 90 | MIT |
| purpleeddy/cladding | 80 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 87a089ac66fe (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100rote
Kompiluje sprawdzony skill agenta do deterministycznego potoku działającego bez LLM i udostępnia go Claude jako narzędzie MCP, aby skill był tańszy, szybszy i stabilniejszy. - 95setup
Prowadzi przez pierwsze uruchomienie rote: import używanych serwerów MCP, kompilację jednego ze skilli i porównanie, że wersja skompilowana odpowiada tak samo, szybciej i taniej. - 100implement
Uzupełnia moduły zastępcze potoku wyemitowanego przez rote, by faktycznie działał: czyta kontrakt IR każdego węzła i zastępuje stuby z błędem „[rote stub]” lub NotImplementedError prawdziwymi wywołaniami. - 84compile
Zamienia powtarzający się przepływ pracy agenta w skompilowany program Amber z testami powtórek i strażnikami, by zmniejszyć zużycie tokenów. - 100superlore-connect-mcp
Rejestruje serwer MCP bazy wiedzy superlore w Claude lub innym kliencie, po zgodzie na zmianę konfiguracji. - 100mcp-server-builder
Buduje, podłącza i debuguje serwer MCP dający Claude dostęp do wewnętrznego API, bazy danych lub narzędzia SaaS, także gdy narzędzia serwera się nie pojawiają.