create prompt and ux

Author: lkingland

cmd/mcp.go

@@ -1,10 +1,7 @@
 package cmd
 
 import (
-	"fmt"
 	"log"
-	"os"
-	"runtime"
 
 	"github.com/spf13/cobra"
 	"knative.dev/func/pkg/mcp"
@@ -13,39 +10,39 @@ import (
 func NewMCPServerCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "mcp",
-		Short: "Manage Model Context Protocol (MCP) server",
+		Short: "The Functions Model Context Protocol (MCP) server",
 		Long: `
 NAME
-	{{rootCmdUse}} mcp - manage a Model Context Protocol (MCP) server
+	{{rootCmdUse}} mcp - The Functions Model Context Protocol (MCP) server
 
 SYNOPSIS
 	{{rootCmdUse}} mcp [command] [flags]
 
 DESCRIPTION
-	Manages a Model Context Protocol (MCP) server over standard input/output (stdio) transport.
-	This server enables AI language models to interact with Knative Functions through the
-	Model Context Protocol.
+	The Functions Model Context Protocol (MCP) server can be used to give agents
+	the power of Functions.
+	
+	Configure your agentic client to use the MCP server with command
+	"{{rootCmdUse}} mcp start".  Then get the conversation started with
 
-	IMPORTANT: This command is designed to be invoked by MCP clients (such as Claude Desktop,
-	Cursor, VS Code, Windsurf, etc.), not run directly by users. The MCP client automatically
-	launches and manages the server based on its configuration.
+	"Let's create a Function!".
 
-	For setup instructions and client configuration examples, see:
-	https://github.com/knative/func/blob/main/docs/mcp-integration/integration.md
+	IMPORTANT: This is an EXPERIMENTAL feature. The FUNC_ENABLE_MCP environment
+	variable must be set before the server will take any meaninigful action.
 
-	Note: This is an EXPERIMENTAL feature. The FUNC_ENABLE_MCP environment variable must be
-	set to "true" for the server to start. See documentation for details.
+	IMPORTANT: "{{rootCmdUse}} mcp start" is designed to be invoked by MCP
+	clients (such as Claude Code, Cursor, VS Code, Windsurf, etc.).  Do not run
+	this directly. Instead, configure your client to invoke.  For setup
+	instructions and client configuration examples, see:
+	https://github.com/knative/func/blob/main/docs/mcp-integration/integration.md
 
 AVAILABLE COMMANDS
-	start    Start the MCP server
+	start    Start the MCP server (for use by your agent)
 
 EXAMPLES
 
 	o View this help:
 		{{rootCmdUse}} mcp --help
-
-	Note: End users should configure their MCP client, not run these commands directly.
-	See the documentation link above for configuration instructions.
 `,
 	}
 
@@ -67,35 +64,16 @@ SYNOPSIS
 	{{rootCmdUse}} mcp start [flags]
 
 DESCRIPTION
-	Starts a Model Context Protocol (MCP) server over standard input/output (stdio) transport.
-	This server provides tools for AI language models to deploy and create Knative serverless
-	functions through the Model Context Protocol.
+	Starts the Model Context Protocol (MCP) server.
 
-	IMPORTANT: This command is designed to be invoked by MCP clients (such as Claude Desktop,
-	Cursor, VS Code, Windsurf, etc.), not run directly by users. The MCP client automatically
-	launches this command based on its configuration and manages the server lifecycle.
+	IMPORTANT: This command is designed to be invoked by MCP clients (such as
+	Claude Desktop, Cursor, VS Code, Windsurf, etc.), not run directly.
 
-	PREREQUISITES:
+	IMPORTANT:
 	- The FUNC_ENABLE_MCP environment variable must be set to "true"
-	- The MCP client must be properly configured
 
 	For detailed setup instructions and client configuration examples, see:
 	https://github.com/knative/func/blob/main/docs/mcp-integration/integration.md
-
-EXAMPLES
-
-	This command is typically not run directly. Instead, configure your MCP client with:
-
-	  {
-	    "mcpServers": {
-	      "func-mcp": {
-	        "command": "{{rootCmdUse}}",
-	        "args": ["mcp", "start"]
-	      }
-	    }
-	  }
-
-	For complete configuration instructions, see the documentation link above.
 `,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return runMCPServer(cmd, args)
@@ -104,74 +82,7 @@ EXAMPLES
 	return cmd
 }
 
-func getEnvVarInstructions() string {
-	switch runtime.GOOS {
-	case "windows":
-		return `  Windows (PowerShell):
-    Set permanently via System Environment Variables:
-    [System.Environment]::SetEnvironmentVariable('FUNC_ENABLE_MCP', 'true', 'User')
-
-    Then restart your terminal/IDE.
-
-    Alternatively, add to your PowerShell profile ($PROFILE):
-    $env:FUNC_ENABLE_MCP = "true"
-
-  Windows (CMD):
-    Set permanently via System Environment Variables GUI:
-    1. Open System Properties → Advanced → Environment Variables
-    2. Add User variable: FUNC_ENABLE_MCP=true
-    3. Restart terminal/IDE`
-
-	case "darwin":
-		return `  macOS:
-    Add to your shell config (~/.zshrc, ~/.bash_profile, etc.):
-    export FUNC_ENABLE_MCP=true
-
-    Then reload: source ~/.zshrc (or restart terminal)`
-
-	case "linux":
-		return `  Linux:
-    Add to your shell config (~/.bashrc, ~/.zshrc, etc.):
-    export FUNC_ENABLE_MCP=true
-
-    Then reload: source ~/.bashrc (or restart terminal)`
-
-	default:
-		// Fallback for unknown OS - show Unix-style instructions
-		return `  Unix/Linux/macOS:
-    Add to your shell config (~/.bashrc, ~/.zshrc, etc.):
-    export FUNC_ENABLE_MCP=true
-
-    Then reload your shell configuration or restart terminal`
-	}
-}
-
 func runMCPServer(cmd *cobra.Command, args []string) error {
-	// Check if experimental MCP feature is explicitly enabled
-	if os.Getenv("FUNC_ENABLE_MCP") != "true" {
-		errorMsg := `Error: MCP server is currently an EXPERIMENTAL feature
-
-WARNING: The MCP (Model Context Protocol) server enables AI language models to
-execute commands on your system, including:
-  - Creating and modifying code
-  - Building container images
-  - Deploying to Kubernetes clusters
-  - Modifying function configurations
-
-AI models can generate incorrect code and make unintended changes.
-USER DISCRETION IS ADVISED.
-
-To enable this experimental feature, set the following environment variable:
-
-%s
-
-For detailed instructions, see: docs/mcp-integration/integration.md`
-
-		fmt.Fprintf(os.Stderr, errorMsg, getEnvVarInstructions())
-		fmt.Fprintln(os.Stderr) // Add final newline
-		os.Exit(1)
-	}
-
 	// Get the root command's path to determine if we're "func" or "kn func"
 	rootCmd := cmd.Root()
 	cmdPrefix := rootCmd.Use

docs/reference/func.md

@@ -34,7 +34,7 @@ Learn more about Knative at: https://knative.dev
 * [func invoke](func_invoke.md)	 - Invoke a local or remote function
 * [func languages](func_languages.md)	 - List available function language runtimes
 * [func list](func_list.md)	 - List deployed functions
-* [func mcp](func_mcp.md)	 - Manage Model Context Protocol (MCP) server
+* [func mcp](func_mcp.md)	 - The Functions Model Context Protocol (MCP) server
 * [func repository](func_repository.md)	 - Manage installed template repositories
 * [func run](func_run.md)	 - Run the function locally
 * [func subscribe](func_subscribe.md)	 - Subscribe a function to events

docs/reference/func_mcp.md

@@ -1,42 +1,42 @@
 ## func mcp
 
-Manage Model Context Protocol (MCP) server
+The Functions Model Context Protocol (MCP) server
 
 ### Synopsis
 
 
 NAME
-	func mcp - manage a Model Context Protocol (MCP) server
+	func mcp - The Functions Model Context Protocol (MCP) server
 
 SYNOPSIS
 	func mcp [command] [flags]
 
 DESCRIPTION
-	Manages a Model Context Protocol (MCP) server over standard input/output (stdio) transport.
-	This server enables AI language models to interact with Knative Functions through the
-	Model Context Protocol.
+	The Functions Model Context Protocol (MCP) server can be used to give agents
+	the power of Functions.
 
-	IMPORTANT: This command is designed to be invoked by MCP clients (such as Claude Desktop,
-	Cursor, VS Code, Windsurf, etc.), not run directly by users. The MCP client automatically
-	launches and manages the server based on its configuration.
+	Configure your agentic client to use the MCP server with command
+	"func mcp start".  Then get the conversation started with
 
-	For setup instructions and client configuration examples, see:
-	https://github.com/knative/func/blob/main/docs/mcp-integration/integration.md
+	"Let's create a Function!".
+
+	IMPORTANT: This is an EXPERIMENTAL feature. The FUNC_ENABLE_MCP environment
+	variable must be set before the server will take any meaninigful action.
 
-	Note: This is an EXPERIMENTAL feature. The FUNC_ENABLE_MCP environment variable must be
-	set to "true" for the server to start. See documentation for details.
+	IMPORTANT: "func mcp start" is designed to be invoked by MCP
+	clients (such as Claude Code, Cursor, VS Code, Windsurf, etc.).  Do not run
+	this directly. Instead, configure your client to invoke.  For setup
+	instructions and client configuration examples, see:
+	https://github.com/knative/func/blob/main/docs/mcp-integration/integration.md
 
 AVAILABLE COMMANDS
-	start    Start the MCP server
+	start    Start the MCP server (for use by your agent)
 
 EXAMPLES
 
 	o View this help:
 		func mcp --help
 
-	Note: End users should configure their MCP client, not run these commands directly.
-	See the documentation link above for configuration instructions.
-
 
 ### Options
 

docs/reference/func_mcp_start.md

@@ -12,36 +12,17 @@ SYNOPSIS
 	func mcp start [flags]
 
 DESCRIPTION
-	Starts a Model Context Protocol (MCP) server over standard input/output (stdio) transport.
-	This server provides tools for AI language models to deploy and create Knative serverless
-	functions through the Model Context Protocol.
+	Starts the Model Context Protocol (MCP) server.
 
-	IMPORTANT: This command is designed to be invoked by MCP clients (such as Claude Desktop,
-	Cursor, VS Code, Windsurf, etc.), not run directly by users. The MCP client automatically
-	launches this command based on its configuration and manages the server lifecycle.
+	IMPORTANT: This command is designed to be invoked by MCP clients (such as
+	Claude Desktop, Cursor, VS Code, Windsurf, etc.), not run directly.
 
-	PREREQUISITES:
+	IMPORTANT:
 	- The FUNC_ENABLE_MCP environment variable must be set to "true"
-	- The MCP client must be properly configured
 
 	For detailed setup instructions and client configuration examples, see:
 	https://github.com/knative/func/blob/main/docs/mcp-integration/integration.md
 
-EXAMPLES
-
-	This command is typically not run directly. Instead, configure your MCP client with:
-
-	  {
-	    "mcpServers": {
-	      "func-mcp": {
-	        "command": "func",
-	        "args": ["mcp", "start"]
-	      }
-	    }
-	  }
-
-	For complete configuration instructions, see the documentation link above.
-
 
 ```
 func mcp start
@@ -55,5 +36,5 @@ func mcp start
 
 ### SEE ALSO
 
-* [func mcp](func_mcp.md)	 - Manage Model Context Protocol (MCP) server
+* [func mcp](func_mcp.md)	 - The Functions Model Context Protocol (MCP) server