docs: document mcp backed rpc server

This commit is contained in:
lda
2026-06-04 23:43:37 +07:00 Verified
parent 0ab609aa1c
commit 9ca7dfb01a
3 changed files with 31 additions and 1 deletions
+3
View File
@@ -158,6 +158,9 @@ implementation state.
catalog snapshots are not mutated. Config-shadowed add is rejected in v1.
Remove requires `--confirm` in CLI; local/static servers report
unavailable.
- Completed: `wf-rpc-server --mcp-config wf_mcp.config.json` starts the
JSON-RPC transport over an MCP-backed `WorkflowServer`, making the remote
CLI path usable with MCP sources and desired source registry operations.
- Cleanup candidate: consolidate store/source registry id validation patterns
(`SOURCE_REGISTRY_ID_PATTERN`, `STORE_ID_PATTERN`) only after another package
needs the same rule. Today they intentionally stay close to their stores.
@@ -2,7 +2,7 @@
Date: 2026-06-03
Status: Slices 1-4 implemented. `wf_server` provides
Status: Slices 1-5 implemented. `wf_server` provides
`build_local_static_workflow_server`; `wf_mcp.broker.server` can adapt MCP
broker config/services into the neutral `WorkflowServer`; `wf_transport_rpc_http`
provides JSON-RPC methods and client support; `wf_cli` has target-aware context;
@@ -109,6 +109,8 @@ Implementation status:
- Slice 4 complete: `wf_mcp.broker.server.build_workflow_server_from_config()`
returns a neutral `WorkflowServer` backed by MCP broker runtime services,
including source registry admin and platform admin surfaces.
- Slice 5 complete: `wf-rpc-server --mcp-config <path>` starts JSON-RPC over an
MCP-backed `WorkflowServer`; `--store-root` remains local/static-only.
First slice should not include:
+25
View File
@@ -13,6 +13,31 @@ wf --config wf_mcp.config.json <command>
If `--config` is omitted, `wf_mcp.config.json` is used.
## Remote Server
Start a local/static JSON-RPC workflow server:
```bash
wf-rpc-server --store-root .wf_store --host 127.0.0.1 --port 8765
```
Start a JSON-RPC server backed by MCP broker config and MCP-capable sources:
```bash
wf-rpc-server --mcp-config wf_mcp.config.json --host 127.0.0.1 --port 8765
```
Then point `wf` at it:
```bash
wf --url http://127.0.0.1:8765/rpc cap list
wf --url http://127.0.0.1:8765/rpc admin registry list
```
`--mcp-config` owns the server's workflow stores, MCP connections, and source
registry. `--store-root` is for the local/static server path and cannot be
combined with `--mcp-config`.
## Output Policy
JSON is the default output format for every command.