G: G2 MCP description document POST /mcp and x-mcp-tools from the tool router
This commit is contained in:
1 parent
3d8e840427
commit
7078ed15b1
3 files changed
+142
-2
No files matched your search
@@ -29,3 +29,7 @@ Reuse existing DTOs, do not duplicate types for the doc. Read-only, no secrets i
|
||||
Translation note for a future merger: if WS-G is ever allowed to touch the DTO files, the derive can replace the bridge for `src/sources/mod.rs`; the peer types would still need `JsonSchema` added.
|
||||
|
||||
Tests: 10 unit tests in `src/openapi.rs` (reflection parity, payload parity, peer gating, operation ids and 2xx, bearer scheme, determinism) and `tests/openapi.rs` with the router drift guard started here (source scan of every `.route(...)` literal in `src/api/**` plus `src/server.rs`, `/api/v1` prefix applied as `server.rs` nests it, axum `{*path}` normalised to OpenAPI `{path}`, and one request per documented path that must not hit the fallback's `no such route`). `cargo fmt --check`, `cargo clippy --all-targets -- -D warnings` and `cargo test` green.
|
||||
|
||||
- 2026-10-20: **G2 MCP description.** MCP is JSON-RPC, so it is documented as one operation `POST /mcp` (declared on a doc-only `mcp_endpoint()` in `src/openapi.rs`; the real handler is rmcp's `StreamableHttpService`, which has no axum handler fn to annotate) with the request body, the `application/json` + `text/event-stream` response, and the 400/401/403/404/406/415 codes rmcp and the auth layer really return. `x-mcp-tools` is generated from the tool router itself: `TrackerService::advertised_tools(peers)` builds the same `ToolRouter` that `TrackerService::new` stores (extracted into `router_for`, so there is one place that applies the peer gating) and returns `name`, `description` and `input_schema` for every tool, sorted, so the extension cannot drift from `tools/list`. Tool count stays 8 without peers and 10 with them; the existing peers-off snapshot test is untouched and still passes.
|
||||
|
||||
Tests: `mcp_endpoint_is_documented_in_both_modes` and `mcp_extension_lists_tools_sorted_with_schemas` in `src/openapi.rs`; `mcp_tools_match_the_tool_router` (every entry equal to the router's name/description/input schema, both modes), `mcp_tool_count_follows_the_peers_flag` and the `/mcp` mount added to the route scan in `tests/openapi.rs`. `cargo fmt --check`, `cargo clippy --all-targets -- -D warnings` and `cargo test` green.
|
||||
Reference in new issue
Block a user