vcluster-yaml-mcp-server 1.2.4 → 1.3.1

package/README.md

@@ -204,6 +204,19 @@ extract-validation-rules --section="controlPlane" --version="v0.24.0"
 // Extracts constraints like "Valid values: a, b, c"
 ```
 
+### Resources
+
+**server://info** - Server metadata including version and available tools
+```javascript
+// Returns: name, version, description, availableTools, build info, runtime
+```
+
+**server://changelog** - Release history
+```javascript
+// Returns: version, content (from CHANGELOG.md)
+// AI assistants check this on first use to mention relevant recent changes
+```
+
 ## Usage Examples
 
 ### Interactive Config Creation (Primary Workflow)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vcluster-yaml-mcp-server",
-  "version": "1.2.4",
+  "version": "1.3.1",
   "description": "MCP server for querying vcluster YAML configurations using jq",
   "repository": {
     "type": "git",

package/src/server-info.js

@@ -1,14 +1,22 @@
-import { readFile } from 'fs/promises';
+import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 
-// Load package.json once at module level
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageJson = JSON.parse(
-  await readFile(join(__dirname, '../package.json'), 'utf-8')
+  readFileSync(join(__dirname, '../package.json'), 'utf-8')
 );
 
+// Available tools (static list for changelog)
+const availableTools = [
+  { name: 'list-versions', description: 'Discover available vCluster versions (tags and branches)' },
+  { name: 'smart-query', description: 'Natural language search for vCluster configuration' },
+  { name: 'create-vcluster-config', description: 'Generate and validate vCluster YAML configs' },
+  { name: 'validate-config', description: 'Validate existing vCluster YAML against schema' },
+  { name: 'extract-validation-rules', description: 'Extract semantic validation rules from values.yaml' }
+];
+
 // Build metadata from environment (injected by Docker/CI)
 const buildInfo = {
   version: packageJson.version,
@@ -38,7 +46,8 @@ export function getServerInfo() {
       nodeVersion: process.version,
       platform: process.platform,
       arch: process.arch
-    }
+    },
+    availableTools
   };
 }
 
@@ -114,6 +123,25 @@ export function getMcpServerOptions() {
       tools: {},
       resources: {}
     },
-    instructions: "vCluster configuration assistant. Use smart-query for any configuration questions (natural language search). Use create-vcluster-config when generating configs - it auto-validates. Use list-versions first to discover available versions. Use validate-config for user-provided YAML. Use extract-validation-rules to understand semantic constraints."
+    instructions: "vCluster configuration assistant. Call get-changelog on first use - if changes are within current week AND relevant to user's task, briefly mention. Use smart-query for configuration questions. Use create-vcluster-config when generating configs (auto-validates). Use list-versions to discover versions. Use validate-config for user YAML. Use extract-validation-rules for semantic constraints."
   };
 }
+
+/**
+ * Get changelog from CHANGELOG.md file
+ * @returns {Object} Changelog with version and content
+ */
+export function getChangelog() {
+  try {
+    const content = readFileSync(join(__dirname, '../CHANGELOG.md'), 'utf-8');
+    return {
+      version: packageJson.version,
+      content
+    };
+  } catch {
+    return {
+      version: packageJson.version,
+      content: 'Changelog unavailable'
+    };
+  }
+}

package/src/server.js

@@ -8,7 +8,7 @@ import {
   handleExtractRules,
   handleValidateConfig
 } from './tool-handlers.js';
-import { getMcpServerInfo, getMcpServerOptions, getServerInfo } from './server-info.js';
+import { getMcpServerInfo, getMcpServerOptions, getServerInfo, getChangelog } from './server-info.js';
 
 export function createServer() {
   const serverInfo = getMcpServerInfo();
@@ -112,6 +112,32 @@ export function createServer() {
     }
   );
 
+  // Register: get-server-info (tool wrapper for clients that don't support resources)
+  server.registerTool(
+    'get-server-info',
+    {
+      description: 'Get server version, available tools, and metadata. Call on first use to check for updates.',
+      inputSchema: z.object({}),
+      annotations: { readOnlyHint: true }
+    },
+    async () => ({
+      content: [{ type: 'text', text: JSON.stringify(getServerInfo(), null, 2) }]
+    })
+  );
+
+  // Register: get-changelog
+  server.registerTool(
+    'get-changelog',
+    {
+      description: 'Get recent release history. Check for changes relevant to your task.',
+      inputSchema: z.object({}),
+      annotations: { readOnlyHint: true }
+    },
+    async () => ({
+      content: [{ type: 'text', text: JSON.stringify(getChangelog(), null, 2) }]
+    })
+  );
+
   // Register resource: server://info
   server.registerResource(
     'server-info',
@@ -131,5 +157,24 @@ export function createServer() {
     })
   );
 
+  // Register resource: server://changelog
+  server.registerResource(
+    'server-changelog',
+    'server://changelog',
+    {
+      description: 'Recent release history with dates and changes',
+      mimeType: 'application/json'
+    },
+    async (uri) => ({
+      contents: [
+        {
+          uri: uri.href,
+          mimeType: 'application/json',
+          text: JSON.stringify(getChangelog(), null, 2)
+        }
+      ]
+    })
+  );
+
   return server;
 }