@webpieces/mcp-server 0.4.931 → 0.4.933
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 +7 -1
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -50,11 +50,17 @@ contract by `@webpieces/api-doc-model` at BUILD time:
|
|
|
50
50
|
|---|---|
|
|
51
51
|
| `title` / `annotations.title` | `@WpMcpTool`'s second argument |
|
|
52
52
|
| `description` | the method's JSDoc body, or its `@mcp` tag — the same words the partner reads in OpenAPI |
|
|
53
|
-
| `inputSchema` / `outputSchema` | the declared request and response types, with each field's JSDoc as its description |
|
|
53
|
+
| `inputSchema` / `outputSchema` | the declared request and response types, with each field's JSDoc as its description; `inputSchema.description` is the request DTO's JSDoc and `outputSchema.description` is the method's `@returns` — the sentence OpenAPI publishes as the success response's description (#1292) |
|
|
54
54
|
| `readOnlyHint` / `destructiveHint` / `idempotentHint` | `@Endpoint`'s `operation` — `READ`, `WRITE_IDEMPOTENT` or `WRITE` |
|
|
55
55
|
| `openWorldHint` | `@Endpoint`'s `openWorld` option |
|
|
56
56
|
| `x-mcp-header` | the field's `@mcpHeader <token>` JSDoc tag |
|
|
57
57
|
|
|
58
|
+
No `@privateRemarks` text reaches any of it: the generator drops the tag at extraction, and it refuses
|
|
59
|
+
a tool whose method has no `@returns` or that reaches a schema with no JSDoc description, exactly as it
|
|
60
|
+
refuses them for OpenAPI (#1292). The server serves the catalog's descriptions verbatim —
|
|
61
|
+
`McpServedDescriptions.integration.spec.ts` boots it on the partner-api golden catalog and reads them
|
|
62
|
+
back through `tools/list`.
|
|
63
|
+
|
|
58
64
|
Every `@Endpoint` declares one enum-backed operation, independent of its required `GET` or `POST`
|
|
59
65
|
argument: a GET may deliberately write and a POST may be a read. A tool therefore cannot claim to be
|
|
60
66
|
read-only while its endpoint declares `WRITE` — the contradiction is unrepresentable.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@webpieces/mcp-server",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.933",
|
|
4
4
|
"description": "Secure MCP tool generation from annotated Webpieces API contracts",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"main": "./src/index.js",
|
|
@@ -24,15 +24,15 @@
|
|
|
24
24
|
"dependencies": {
|
|
25
25
|
"@modelcontextprotocol/node": "2.0.0",
|
|
26
26
|
"@modelcontextprotocol/server": "2.0.0",
|
|
27
|
-
"@webpieces/core-context": "0.4.
|
|
28
|
-
"@webpieces/core-util": "0.4.
|
|
29
|
-
"@webpieces/http-routing": "0.4.
|
|
30
|
-
"@webpieces/http-server": "0.4.
|
|
27
|
+
"@webpieces/core-context": "0.4.933",
|
|
28
|
+
"@webpieces/core-util": "0.4.933",
|
|
29
|
+
"@webpieces/http-routing": "0.4.933",
|
|
30
|
+
"@webpieces/http-server": "0.4.933",
|
|
31
31
|
"express": "5.1.0",
|
|
32
32
|
"reflect-metadata": "0.2.2",
|
|
33
33
|
"tslib": "2.8.1"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
36
|
-
"@webpieces/http-client-node": "0.4.
|
|
36
|
+
"@webpieces/http-client-node": "0.4.933"
|
|
37
37
|
}
|
|
38
38
|
}
|