Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

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.

Repozytorium
rote ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

register my compiled pipelineserve my pipelines over MCPtrigger the workflow from Claudehook the pipeline up to Claude
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. 1. Check preconditions
  2. 2. Register the pipeline
  3. 3. Add the MCP server to Claude
  4. 4. Explain the reconnect caveat
Sekcje z nagłówków SKILL.md, w oryginale · 99 linii, 580 słów
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

RepozytoriumWynikLicencja
Ta strona · trevhud/rote100Apache-2.0
ccplugins/awesome-claude-code-plugins100Apache-2.0
tomascupr/sous-chef100MIT
pavelvod/lantern91MIT
clockgrove/factory90MIT
purpleeddy/cladding80MIT

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ą.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.