@hediet/linkrpc-cli 0.0.3-next.20261030.2 → 0.0.3-next.20261031.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -935,9 +935,11 @@ idle minutes.
935
935
 
936
936
  ### Hub MCP aggregation
937
937
 
938
- `linkrpc hub mcp` is a lightweight stdio MCP server that discovers services
939
- exposing `vscode.mcp-forward` in the selected Hub and aggregates their tools.
940
- No service IDs, filters, or principal overrides are required:
938
+ `linkrpc hub mcp` is a lightweight stdio MCP server that discovers every MCP
939
+ server published in the selected Hub and aggregates their tools: typed bridges
940
+ (`mcp.tools`) and forwarded servers (`mcp.forward`, or the legacy
941
+ `vscode.mcp-forward`). No service IDs, filters, or principal overrides are
942
+ required:
941
943
 
942
944
  ```json
943
945
  {
@@ -955,8 +957,15 @@ Endpoint/context/environment and identity selection follow the normal Hub CLI
955
957
  rules. An explicit endpoint can be supplied before `mcp`, for example
956
958
  `linkrpc hub --endpoint npipe://./pipe/my-hub mcp`. Signing and capability
957
959
  negotiation remain enabled by default; discovery does not bypass authorization.
958
- Inaccessible directories and failed servers are reported on stderr; stdout
959
- contains only MCP protocol frames.
960
+ Typed tools are called through their generated methods, so capabilities and
961
+ consent apply per tool; a forwarded server needs one capability for all its
962
+ tools. Inaccessible directories and failed servers are reported on stderr;
963
+ stdout contains only MCP protocol frames.
964
+
965
+ `--scripts` additionally serves the LinkRPC script tools (`runLinkRpcScript`,
966
+ `awaitLinkRpcTask`, `cancelLinkRpcTask`) of `@hediet/linkrpc-mcp` on the same
967
+ connection, so one MCP entry gives both the hub's MCP tools and scripted access
968
+ to every hub service.
960
969
 
961
970
  The command watches directory changes, refreshes changed tool lists (including
962
971
  paginated lists), and retries failed connections while they remain advertised.
@@ -965,7 +974,23 @@ remaining unique and MCP-safe even for long service paths. Descriptions identify
965
974
  the source service. Disconnecting stdio closes this client's forwarding sessions.
966
975
  This version aggregates tools, not resources, prompts, or sampling.
967
976
 
968
- The producer stays separate:
977
+ ### Publishing MCP servers
978
+
979
+ Producers stay separate. `mcp-publish` publishes one MCP server, given as a
980
+ command after `--` or as a Streamable HTTP `--url` (with repeatable `--header`):
981
+
982
+ ```sh
983
+ linkrpc hub mcp-publish --typed --forward --serviceId <authorized-service-id> -- npx -y @modelcontextprotocol/server-everything
984
+ ```
985
+
986
+ - `--typed` exposes every MCP tool as a method of a generated
987
+ `mcp.tools.<name>` interface (`--name`, derived from the service ID by
988
+ default). All callers share one MCP session; a caller can open an exclusive
989
+ one with `mcp.server::openSession`.
990
+ - `--forward` relays MCP verbatim over `mcp.forward`. Each connection gets its
991
+ own MCP session: a fresh child process, or a new HTTP session.
992
+
993
+ `mcp-forward` is shorthand for `mcp-publish --forward`:
969
994
 
970
995
  ```sh
971
996
  linkrpc hub mcp-forward --serviceId <authorized-service-id> -- component-explorer mcp -p <config> --use-daemon --no-daemon-autostart
@@ -975,7 +1000,8 @@ Manage that producer and `component-explorer serve -p <same-config>` with your
975
1000
  workspace daemon. The aggregator opens lightweight MCP connections; it does not
976
1001
  start workspace builds or explorer daemons. Each forwarded connection spawns
977
1002
  the configured MCP child, so producers must use attach-only commands when
978
- heavyweight services are managed separately.
1003
+ heavyweight services are managed separately. Children inherit the producer's
1004
+ environment plus `--env` values.
979
1005
 
980
1006
  ### Participant proxy
981
1007