kubeview-mcp 1.7.5 → 1.7.6

package/CHANGELOG.md

@@ -5,14 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [1.7.6] - 2026-05-03
+
+### Added
+- **Streamable HTTP transport mode** with configurable host, port, path, stateless mode, JSON responses, and host/origin allowlists.
+
+### Changed
+- **Refactor MCP server startup** to support explicit transport injection and shared mode-specific server creation.
+- **Upgrade `@modelcontextprotocol/sdk` to `^1.29.0`** for newer Streamable HTTP transport support and compatibility updates.
+
+### Fixed
+- **HTTP runtime correctness**: handle IPv6 `::1` bindings correctly, return JSON-RPC parse errors for malformed HTTP request bodies, and stop pre-session app servers when `initialize` is rejected before a session is created.
+- **HTTP startup reporting**: log the actual bound port when `MCP_HTTP_PORT=0` assigns an ephemeral port.
+- **Transport config scoping**: only enforce HTTP host allowlist validation when `MCP_TRANSPORT=http`, so default `stdio` startup is unaffected by HTTP-only environment variables.
 
 ## [1.7.5] - 2026-04-22
 
 ### Changed
 - **Update hono to version 4.12.14.**
 
-
 ## [1.7.4] - 2026-04-08
 
 ### Changed

package/README.md

@@ -59,9 +59,37 @@ Add to your `mcpServers` config (Cursor, Claude Desktop, etc.):
 | Variable             | Description                                  | Default          |
 | -------------------- | -------------------------------------------- | ---------------- |
 | `KUBECONFIG`         | Path to kubeconfig file                      | `~/.kube/config` |
+| `MCP_TRANSPORT`      | Transport: `stdio` (default) or `http`       | `stdio`          |
 | `MCP_MODE`           | Server mode: `all`, `code`, or `tools`       | `all`            |
 | `MCP_LOG_LEVEL`      | Log level: `error`, `warn`, `info`, `debug`  | `info`           |
 | `MCP_HIDE_SENSITIVE` | Mask sensitive data globally                 | `false`          |
+| `MCP_HTTP_HOST`      | HTTP bind host when `MCP_TRANSPORT=http`     | `127.0.0.1`      |
+| `MCP_HTTP_PORT`      | HTTP port when `MCP_TRANSPORT=http`          | `3000`           |
+| `MCP_HTTP_PATH`      | Streamable HTTP endpoint path                | `/mcp`           |
+| `MCP_HTTP_STATELESS` | Disable session IDs in HTTP mode             | `false`          |
+| `MCP_HTTP_JSON_RESPONSE` | Prefer JSON responses over SSE           | `false`          |
+| `MCP_ALLOWED_HOSTS`  | Comma-separated Host allowlist for HTTP mode | local defaults   |
+| `MCP_ALLOWED_ORIGINS`| Comma-separated Origin allowlist for HTTP mode | unset         |
+
+### Streamable HTTP Mode
+
+KubeView can also run as a standalone **Streamable HTTP** server for hosted or manually managed deployments.
+
+```bash
+MCP_TRANSPORT=http \
+MCP_HTTP_HOST=127.0.0.1 \
+MCP_HTTP_PORT=3000 \
+npx -y kubeview-mcp
+```
+
+This starts a Streamable HTTP endpoint at `http://127.0.0.1:3000/mcp`.
+
+Notes:
+
+- `stdio` remains the default and is still the right choice for MCP client configs such as Claude Desktop, Cursor, and Codex CLI.
+- `MCP_HTTP_STATELESS=true` disables session IDs. That is useful for simple request/response patterns, but stateful features such as `plan_step` history are not meaningful in that mode.
+- If you bind HTTP mode to `0.0.0.0` or `::`, you must set `MCP_ALLOWED_HOSTS`.
+- HTTP mode is intended for manual deployment. The published MCP registry metadata still targets `stdio`.
 
 ---
 

package/dist/src/index.d.ts

@@ -1,15 +1,12 @@
 #!/usr/bin/env node
 /**
  * Kubernetes MCP Server
- * Main entry point for the Model Context Protocol server
- *
- * Modes (MCP_MODE env var):
- * - code: exposes only `run_code` for agent code execution
- * - tools: exposes only Kubernetes, Helm, and Argo tools (no `run_code`)
- * - all (default): exposes both tools and `run_code`
- *   per https://www.anthropic.com/engineering/code-execution-with-mcp
+ * Main entry point for the Model Context Protocol server.
  */
+import { MCPServer } from './server/MCPServer.js';
 import { VERSION } from './version.js';
 export { VERSION };
+type MCPMode = 'code' | 'tools' | 'all';
+export declare function createServerForMode(mode: MCPMode): Promise<MCPServer>;
 export declare function main(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAUH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,CAAC;AAyKnB,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AASlD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAqGxC,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAiB3E;AAcD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB1C"}

package/dist/src/index.js

@@ -1,49 +1,46 @@
 #!/usr/bin/env node
 /**
  * Kubernetes MCP Server
- * Main entry point for the Model Context Protocol server
- *
- * Modes (MCP_MODE env var):
- * - code: exposes only `run_code` for agent code execution
- * - tools: exposes only Kubernetes, Helm, and Argo tools (no `run_code`)
- * - all (default): exposes both tools and `run_code`
- *   per https://www.anthropic.com/engineering/code-execution-with-mcp
+ * Main entry point for the Model Context Protocol server.
  */
 import { MCPServer } from './server/MCPServer.js';
+import { StreamableHttpRuntime } from './server/StreamableHttpRuntime.js';
+import { loadTransportConfig } from './server/TransportConfig.js';
 import { KubernetesToolsPlugin } from './plugins/KubernetesToolsPlugin.js';
 import { HelmToolsPlugin } from './plugins/HelmToolsPlugin.js';
 import { ArgoToolsPlugin } from './plugins/ArgoToolsPlugin.js';
 import { ArgoCDToolsPlugin } from './plugins/ArgoCDToolsPlugin.js';
 import { RunCodeTool } from './tools/RunCodeTool.js';
+import { loadCodeModeConfig } from './utils/CodeModeConfig.js';
 import { VERSION } from './version.js';
 export { VERSION };
-import { loadCodeModeConfig } from './utils/CodeModeConfig.js';
-/**
- * Code-mode bootstrap: minimal surface with only `run_code` tool.
- * Follows progressive disclosure per Anthropic's MCP code execution approach.
- * Loads all plugins internally so run_code can execute tool calls.
- */
-async function startCodeMode(server) {
-    const config = loadCodeModeConfig();
-    // Load all plugins internally (not exposed to MCP, but available for code execution)
-    const internalServer = new MCPServer({
-        skipTransportErrorHandling: true,
-        skipGracefulShutdown: true,
-    });
-    const kubernetesPlugin = new KubernetesToolsPlugin();
-    await internalServer.loadPlugin(kubernetesPlugin);
+function getMCPMode() {
+    const mode = process.env.MCP_MODE?.toLowerCase();
+    if (mode === 'code' || mode === 'tools' || mode === 'all') {
+        return mode;
+    }
+    return 'all';
+}
+async function loadOptionalPlugins(server) {
     const optionalPlugins = [new HelmToolsPlugin(), new ArgoToolsPlugin(), new ArgoCDToolsPlugin()];
     for (const plugin of optionalPlugins) {
         try {
-            await internalServer.loadPlugin(plugin);
+            await server.loadPlugin(plugin);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
             console.error(`Optional plugin '${plugin.name}' skipped: ${message}`);
         }
     }
-    // Create tool executor that calls internal tools
-    // Strip server prefix from qualified names (e.g., "kubeview-mcp__kube_list" → "kube_list")
+}
+async function configureCodeModeServer(server) {
+    const config = loadCodeModeConfig();
+    const internalServer = new MCPServer({
+        skipTransportErrorHandling: true,
+        skipGracefulShutdown: true,
+    });
+    await internalServer.loadPlugin(new KubernetesToolsPlugin());
+    await loadOptionalPlugins(internalServer);
     const toolExecutor = async (qualifiedName, args) => {
         const toolName = qualifiedName.includes('__')
             ? qualifiedName.split('__').pop()
@@ -54,14 +51,12 @@ async function startCodeMode(server) {
     runCodeTool.setToolExecutor(toolExecutor);
     runCodeTool.setTools(internalServer.getTools());
     server.registerTool(runCodeTool.tool, (params) => runCodeTool.execute(params));
-    // Register global.d.ts resource for type definitions
     server.registerResource({
         uri: 'file:///sys/global.d.ts',
         name: 'Global Type Definitions',
         mimeType: 'application/typescript',
         text: runCodeTool.generateGlobalDts(),
     });
-    // Register code-mode prompt with tool overview and examples
     server.registerPrompt({
         name: 'code-mode',
         description: 'Injects TypeScript definitions and API docs for Code Mode with tool overview and examples.',
@@ -73,68 +68,25 @@ async function startCodeMode(server) {
             },
         ],
     });
-    await server.start();
-    console.error(`KubeView MCP is running in code-mode. ` +
-        'Only `run_code` tool exposed; code can call all Kubernetes/Helm/Argo tools.');
 }
-/**
- * Tools-only mode: loads all Kubernetes, Helm, Argo, and ArgoCD plugins without run_code.
- */
-async function startToolsMode(server) {
-    const kubernetesPlugin = new KubernetesToolsPlugin();
-    await server.loadPlugin(kubernetesPlugin);
-    const optionalPlugins = [new HelmToolsPlugin(), new ArgoToolsPlugin(), new ArgoCDToolsPlugin()];
-    for (const plugin of optionalPlugins) {
-        try {
-            await server.loadPlugin(plugin);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error(`Optional plugin '${plugin.name}' skipped: ${message}`);
-        }
-    }
-    await server.start();
-    console.error(`KubeView MCP is running in tools-mode. Only Kubernetes/Helm/Argo tools exposed.`);
+async function configureToolsModeServer(server) {
+    await server.loadPlugin(new KubernetesToolsPlugin());
+    await loadOptionalPlugins(server);
 }
-/**
- * All mode: loads all Kubernetes, Helm, Argo, and ArgoCD plugins plus run_code.
- */
-async function startAllMode(server) {
+async function configureAllModeServer(server) {
+    await server.loadPlugin(new KubernetesToolsPlugin());
+    await loadOptionalPlugins(server);
     const config = loadCodeModeConfig();
-    const kubernetesPlugin = new KubernetesToolsPlugin();
-    await server.loadPlugin(kubernetesPlugin);
-    const optionalPlugins = [new HelmToolsPlugin(), new ArgoToolsPlugin(), new ArgoCDToolsPlugin()];
-    for (const plugin of optionalPlugins) {
-        try {
-            await server.loadPlugin(plugin);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error(`Optional plugin '${plugin.name}' skipped: ${message}`);
-        }
-    }
-    // Set up run_code tool
-    const toolExecutor = async (qualifiedName, args) => {
-        return server.executeTool(qualifiedName, args);
-    };
     const runCodeTool = new RunCodeTool(config.sandbox);
-    runCodeTool.setToolExecutor(toolExecutor);
-    // We need to set tools for the description builder.
-    // In all mode, we can get them from the server after plugins are loaded.
-    // However, server.getTools() returns Tool[], but setTools expects Tool[] which is fine.
-    // But wait, RunCodeTool.setTools uses them to build the manifest for the description.
-    // We should do this before registering the tool so the description is correct?
-    // Actually, we can do it before starting the server.
+    runCodeTool.setToolExecutor(async (qualifiedName, args) => server.executeTool(qualifiedName, args));
     runCodeTool.setTools(server.getTools());
     server.registerTool(runCodeTool.tool, (params) => runCodeTool.execute(params));
-    // Register global.d.ts resource for type definitions
     server.registerResource({
         uri: 'file:///sys/global.d.ts',
         name: 'Global Type Definitions',
         mimeType: 'application/typescript',
         text: runCodeTool.generateGlobalDts(),
     });
-    // Register code-mode prompt with tool overview and examples
     server.registerPrompt({
         name: 'code-mode',
         description: 'Injects TypeScript definitions and API docs for Code Mode with tool overview and examples.',
@@ -146,33 +98,51 @@ async function startAllMode(server) {
             },
         ],
     });
-    await server.start();
-    console.error(`KubeView MCP is running. Waiting for connections...`);
 }
-function getMCPMode() {
-    const mode = process.env.MCP_MODE?.toLowerCase();
-    if (mode === 'code' || mode === 'tools' || mode === 'all') {
-        return mode;
+export async function createServerForMode(mode) {
+    const server = new MCPServer();
+    switch (mode) {
+        case 'code':
+            await configureCodeModeServer(server);
+            break;
+        case 'tools':
+            await configureToolsModeServer(server);
+            break;
+        case 'all':
+        default:
+            await configureAllModeServer(server);
+            break;
+    }
+    return server;
+}
+function getReadyMessage(mode) {
+    switch (mode) {
+        case 'code':
+            return 'KubeView MCP is running in code-mode. Only `run_code` tool exposed; code can call all Kubernetes/Helm/Argo tools.';
+        case 'tools':
+            return 'KubeView MCP is running in tools-mode. Only Kubernetes/Helm/Argo tools exposed.';
+        case 'all':
+        default:
+            return 'KubeView MCP is running. Waiting for connections...';
     }
-    return 'all'; // default
 }
 export async function main() {
     console.error(`Kubernetes MCP Server v${VERSION} - Starting...`);
     try {
-        const server = new MCPServer();
         const mode = getMCPMode();
-        switch (mode) {
-            case 'code':
-                await startCodeMode(server);
-                break;
-            case 'tools':
-                await startToolsMode(server);
-                break;
-            case 'all':
-            default:
-                await startAllMode(server);
-                break;
+        const transportConfig = loadTransportConfig();
+        if (transportConfig.transport === 'http') {
+            const runtime = new StreamableHttpRuntime(transportConfig.http, {
+                createAppServer: () => createServerForMode(mode),
+            });
+            await runtime.start();
+            const { host, port, path } = runtime.getAddress();
+            runtime.logInfo(`${getReadyMessage(mode)} HTTP endpoint: http://${host}:${port}${path}`);
+            return;
         }
+        const server = await createServerForMode(mode);
+        await server.start();
+        console.error(getReadyMessage(mode));
     }
     catch (error) {
         console.error('Failed to start MCP server:', error);

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/server/MCPServer.d.ts

@@ -1,4 +1,5 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { Tool, Resource } from '@modelcontextprotocol/sdk/types.js';
 import winston from 'winston';
 /**
@@ -44,8 +45,10 @@ export interface MCPServerOptions {
 export declare class MCPServer {
     private static readonly MAX_MALFORMED_STDIN_LOGS;
     private server;
-    private transport;
+    private transport?;
     private logger;
+    private hasLoggedStartupBegin;
+    private hasLoggedStartupSuccess;
     private clientLoggingLevel?;
     private tools;
     private resources;
@@ -70,12 +73,13 @@ export declare class MCPServer {
      * Remove all tracked event listeners
      */
     private removeAllListeners;
+    private isStdioTransport;
     /**
-     * Set up custom error handling for the transport
+     * Set up stdio-specific error handling for the transport.
      */
-    private setupTransportErrorHandling;
+    private setupStdioTransportErrorHandling;
     /**
-     * Attempt to gracefully restart the server connection
+     * Attempt to gracefully restart the stdio server connection
      */
     private gracefulRestart;
     /**
@@ -115,9 +119,13 @@ export declare class MCPServer {
      */
     start(): Promise<void>;
     /**
-     * Connect to the transport with improved error handling
+     * Start the MCP server with an explicit transport.
      */
-    private connectWithErrorHandling;
+    startWithTransport(transport: Transport): Promise<void>;
+    /**
+     * Connect to stdio with improved error handling
+     */
+    private connectStdioWithErrorHandling;
     /**
      * Inspect newline-delimited JSON-RPC messages and emit user-friendly diagnostics.
      */
@@ -143,6 +151,14 @@ export declare class MCPServer {
      * Clean up resources and event listeners (useful for tests)
      */
     cleanup(): void;
+    /**
+     * Emit the standard startup-begin log once, even if startup is split across phases.
+     */
+    logStartupBegin(): void;
+    /**
+     * Emit the standard startup-success log once, even if startup is split across phases.
+     */
+    logStartupSuccess(): void;
     /**
      * Build a stderr-only logger with optional file output and MCP log forwarding.
      */

package/dist/src/server/MCPServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPServer.d.ts","sourceRoot":"","sources":["../../../src/server/MCPServer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MCPServer.d.ts","sourceRoot":"","sources":["../../../src/server/MCPServer.ts"],"names":[],"mappings":"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"}

package/dist/src/server/MCPServer.js

@@ -76,6 +76,8 @@ export class MCPServer {
     server;
     transport;
     logger;
+    hasLoggedStartupBegin = false;
+    hasLoggedStartupSuccess = false;
     clientLoggingLevel;
     tools = new Map();
     resources = new Map();
@@ -105,15 +107,9 @@ export class MCPServer {
                 logging: {},
             },
         });
-        // Initialize stdio transport
-        this.transport = new StdioServerTransport();
         this.clientLoggingLevel = this.parseLoggingLevel(process.env.MCP_CLIENT_LOG_LEVEL);
         // Initialize Winston logger (stderr only to avoid interfering with MCP stdout)
         this.logger = this.createLogger();
-        // Add custom error handler to the transport (skip in tests)
-        if (!options.skipTransportErrorHandling) {
-            this.setupTransportErrorHandling();
-        }
         // Set up handlers
         this.setupHandlers();
         // Set up graceful shutdown (skip in tests to avoid process listeners)
@@ -194,10 +190,13 @@ export class MCPServer {
         }
         this.eventListeners = [];
     }
+    isStdioTransport(transport) {
+        return transport instanceof StdioServerTransport;
+    }
     /**
-     * Set up custom error handling for the transport
+     * Set up stdio-specific error handling for the transport.
      */
-    setupTransportErrorHandling() {
+    setupStdioTransportErrorHandling() {
         // Handle connection errors in the transport
         // StdioServerTransport uses the process stdin/stdout directly
         this.addTrackedListener(process.stdin, 'error', (error) => {
@@ -223,10 +222,10 @@ export class MCPServer {
         }
     }
     /**
-     * Attempt to gracefully restart the server connection
+     * Attempt to gracefully restart the stdio server connection
      */
     async gracefulRestart() {
-        if (this.isShuttingDown)
+        if (this.isShuttingDown || !this.isStdioTransport(this.transport))
             return;
         this.logger.info('Attempting to gracefully restart server connection...');
         try {
@@ -479,17 +478,27 @@ export class MCPServer {
      * Start the MCP server
      */
     async start() {
-        this.logger.info('Starting MCP server...');
+        await this.startWithTransport(new StdioServerTransport());
+    }
+    /**
+     * Start the MCP server with an explicit transport.
+     */
+    async startWithTransport(transport) {
+        this.logStartupBegin();
+        this.transport = transport;
         try {
             if (this.options.skipTransportErrorHandling) {
                 // Simple connection for tests
-                await this.server.connect(this.transport);
+                await this.server.connect(transport);
+            }
+            else if (this.isStdioTransport(transport)) {
+                this.setupStdioTransportErrorHandling();
+                await this.connectStdioWithErrorHandling(transport);
             }
             else {
-                // Wrap the connection with our custom error handling for production
-                await this.connectWithErrorHandling();
+                await this.server.connect(transport);
             }
-            this.logger.info('MCP server started successfully');
+            this.logStartupSuccess();
         }
         catch (error) {
             this.logger.error('Failed to start MCP server', error);
@@ -497,9 +506,9 @@ export class MCPServer {
         }
     }
     /**
-     * Connect to the transport with improved error handling
+     * Connect to stdio with improved error handling
      */
-    async connectWithErrorHandling() {
+    async connectStdioWithErrorHandling(transport) {
         // Validate incoming JSON-RPC frames without disrupting SDK listeners.
         const validateChunk = (chunk) => {
             try {
@@ -525,7 +534,7 @@ export class MCPServer {
             this.addTrackedListener(process.stdin, 'data', validateChunk);
         }
         // Connect to the transport
-        await this.server.connect(this.transport);
+        await this.server.connect(transport);
     }
     /**
      * Inspect newline-delimited JSON-RPC messages and emit user-friendly diagnostics.
@@ -629,6 +638,26 @@ export class MCPServer {
     cleanup() {
         this.removeAllListeners();
     }
+    /**
+     * Emit the standard startup-begin log once, even if startup is split across phases.
+     */
+    logStartupBegin() {
+        if (this.hasLoggedStartupBegin) {
+            return;
+        }
+        this.hasLoggedStartupBegin = true;
+        this.logger.info('Starting MCP server...');
+    }
+    /**
+     * Emit the standard startup-success log once, even if startup is split across phases.
+     */
+    logStartupSuccess() {
+        if (this.hasLoggedStartupSuccess) {
+            return;
+        }
+        this.hasLoggedStartupSuccess = true;
+        this.logger.info('MCP server started successfully');
+    }
     /**
      * Build a stderr-only logger with optional file output and MCP log forwarding.
      */