@vantageos/mcp-boilerplate 0.1.1 → 0.1.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vantage-mcp-boilerplate",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Clonable dual-transport MCP server template (stdio + Streamable HTTP, stateless) on the official @modelcontextprotocol/sdk, with protocol-kit result types, OAuth 2.1 auth + public tier, multi-tenant JWT scoping, MCP Apps UI extension, server-side FR/EN i18n, and a declarative eval harness. Scaffold, extend, publish.",
   "description_fr": "Template de serveur MCP clonable a double transport (stdio + Streamable HTTP, stateless) sur le @modelcontextprotocol/sdk officiel, avec types de resultats protocol-kit, auth OAuth 2.1 + tier public, scoping multi-tenant par JWT, extension UI MCP Apps, i18n FR/EN cote serveur, et un harnais d'evaluations declaratif. Scaffolder, etendre, publier.",
   "author": "ElPi Corp / Laurent Perello",
@@ -8,5 +8,18 @@
   "homepage": "https://github.com/elpiarthera/vantage-mcp-boilerplate",
   "category": "mcp-server",
   "bilingual": true,
-  "keywords": ["mcp", "claude-code", "boilerplate", "starter", "template", "stdio", "streamable-http", "oauth", "multi-tenant", "i18n", "vantage", "elpi"]
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "boilerplate",
+    "starter",
+    "template",
+    "stdio",
+    "streamable-http",
+    "oauth",
+    "multi-tenant",
+    "i18n",
+    "vantage",
+    "elpi"
+  ]
 }

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-08-07
+
+Two derive-never-type fixes, released together.
+
+### Fixed
+
+- `tools/list` gating bug: the response was a hand-typed 2-entry descriptor
+  array (`ping`, `list_items`) while a third tool, `render_items_ui` (MCP
+  Apps UI), was registered on the server — callable but undiscoverable via
+  `tools/list`. The handler now derives the response from the SDK's own
+  registered-tools map, so no tool can be silently missing from discovery
+  again.
+- `.claude-plugin/plugin.json`'s `version` field had drifted from
+  `package.json` (0.1.0 vs 0.1.1). It is now derived from `package.json` at
+  build time (`scripts/sync-plugin-version.mjs`, wired into `npm run build`).
+
 ## [0.1.1] - 2026-08-07
 
 Hardening pass on the published template — packaging and documentation

package/dist/mcpServerFactory.js

@@ -158,8 +158,27 @@ export function createBoilerplateMcpServer(deps = {}) {
     // top of the standard `tools` array every MCP client expects. The kit's
     // `buildToolsListResult` (0.2.0+) emits the `tools` key the official
     // `ListToolsResultSchema` requires directly — no hand alias needed.
-    server.server.setRequestHandler(ListToolsRequestSchema, async () => {
-        return buildToolsListResult([PING_TOOL_DESCRIPTOR, LIST_ITEMS_TOOL_DESCRIPTOR], {
+    //
+    // DERIVATION (not a hand-typed descriptor list): the SDK's own McpServer
+    // already builds the `tools/list` response from its single source of
+    // truth — `this._registeredTools`, populated by every `registerTool`/
+    // `registerAppTool` call above — and installs that handler on
+    // `server.server` (the low-level `Server`) via `setToolRequestHandlers()`
+    // BEFORE this function runs. Re-invoking that already-installed handler,
+    // then re-shaping its `tools` array through the kit, means a 4th
+    // registered tool appears here automatically — nothing here enumerates
+    // tool names by hand, so a tool can never again be silently missing from
+    // discovery just because this list forgot to mention it.
+    const baseListToolsHandler = server.server._requestHandlers.get("tools/list");
+    if (!baseListToolsHandler) {
+        throw new Error("tools/list handler not found on the SDK's Server — McpServer.registerTool() " +
+            "installs it lazily on first registration; this indicates no tool was ever " +
+            "registered, which is a boilerplate wiring bug, not a runtime condition to " +
+            "silently work around.");
+    }
+    server.server.setRequestHandler(ListToolsRequestSchema, async (request, extra) => {
+        const { tools } = await baseListToolsHandler(request, extra);
+        return buildToolsListResult(tools, {
             ttlMs: 60_000,
             cacheScope: "public",
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vantageos/mcp-boilerplate",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Clonable MCP server skeleton: dual-transport bootstrap (stdio + Streamable HTTP, stateless) on the official @modelcontextprotocol/sdk, ready to extend with protocol-kit, auth, tenant and UI layers.",
   "description_fr": "Squelette de serveur MCP clonable : bootstrap double-transport (stdio + Streamable HTTP, sans état) sur le @modelcontextprotocol/sdk officiel, prêt à étendre avec les couches protocol-kit, authentification, tenant et UI.",
   "type": "module",
@@ -38,7 +38,7 @@
   "homepage": "https://github.com/elpiarthera/vantage-mcp-boilerplate#readme",
   "author": "ElPi Corp / Laurent Perello",
   "scripts": {
-    "build": "tsc && mkdir -p dist/locales && cp src/locales/en.json src/locales/fr.json dist/locales/",
+    "build": "tsc && mkdir -p dist/locales && cp src/locales/en.json src/locales/fr.json dist/locales/ && node scripts/sync-plugin-version.mjs",
     "build:ui": "vite build && mv dist/ui-bundle/index.html dist/ui-bundle/widget.html",
     "pretest": "npm run build && npm run build:ui",
     "test": "vitest run",