Add init command docs

Author: kgprs

cmd/docker-mcp/commands/server.go

@@ -141,7 +141,7 @@ func serverCommand(docker docker.Client, dockerCli command.Cli) *cobra.Command {
 	}
 	initCommand.Flags().StringVar(&language, "language", "go", "Programming language for the server (currently only 'go' is supported)")
 	initCommand.Flags().StringVar(&templateName, "template", "basic", "Template to use (basic, chatgpt-app-basic)")
-	initCommand.MarkFlagRequired("template")
+	_ = initCommand.MarkFlagRequired("template")
 	cmd.AddCommand(initCommand)
 
 	return cmd

cmd/docker-mcp/server/init.go

@@ -90,7 +90,7 @@ func getTemplateSet(templateName string) (*templateSet, error) {
 }
 
 // Init initializes a new MCP server project in the specified directory
-func Init(ctx context.Context, dir string, language string, templateName string) error {
+func Init(_ context.Context, dir string, language string, templateName string) error {
 	if language != "go" {
 		return fmt.Errorf("unsupported language: %s (currently only 'go' is supported)", language)
 	}
@@ -102,7 +102,7 @@ func Init(ctx context.Context, dir string, language string, templateName string)
 	}
 
 	// Create directory if it doesn't exist
-	if err := os.MkdirAll(dir, 0755); err != nil {
+	if err := os.MkdirAll(dir, 0o755); err != nil {
 		return fmt.Errorf("creating directory: %w", err)
 	}
 
@@ -121,12 +121,12 @@ func Init(ctx context.Context, dir string, language string, templateName string)
 
 	// Generate files from templates
 	files := map[string]string{
-		"main.go":       templates.mainGo,
-		"Dockerfile":    templates.dockerfile,
-		"compose.yaml":  templates.compose,
-		"catalog.yaml":  templates.catalog,
-		"go.mod":        templates.goMod,
-		"README.md":     templates.readme,
+		"main.go":      templates.mainGo,
+		"Dockerfile":   templates.dockerfile,
+		"compose.yaml": templates.compose,
+		"catalog.yaml": templates.catalog,
+		"go.mod":       templates.goMod,
+		"README.md":    templates.readme,
 	}
 
 	// Add ui.html for chatgpt-app-basic template
@@ -148,7 +148,7 @@ func Init(ctx context.Context, dir string, language string, templateName string)
 
 		// Write file
 		path := filepath.Join(dir, filename)
-		if err := os.WriteFile(path, buf.Bytes(), 0644); err != nil {
+		if err := os.WriteFile(path, buf.Bytes(), 0o644); err != nil {
 			return fmt.Errorf("writing %s: %w", filename, err)
 		}
 	}

cmd/docker-mcp/server/templates/basic/main.go

@@ -22,7 +22,7 @@ func main() {
 	mcp.AddTool(server, &mcp.Tool{
 		Name:        "greet",
 		Description: "say hi",
-	}, func(ctx context.Context, req *mcp.CallToolRequest, args args) (*mcp.CallToolResult, any, error) {
+	}, func(_ context.Context, _ *mcp.CallToolRequest, args args) (*mcp.CallToolResult, any, error) {
 		return &mcp.CallToolResult{
 			Content: []mcp.Content{
 				&mcp.TextContent{Text: "Hi " + args.Name},

cmd/docker-mcp/server/templates/chatgpt-app-basic/main.go

@@ -21,7 +21,7 @@ func main() {
 		Name:        "Greeter Widget",
 		Description: "Interactive UI for the greeter tool",
 		MIMEType:    "text/html+skybridge",
-	}, func(ctx context.Context, req *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
+	}, func(_ context.Context, _ *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
 		return &mcp.ReadResourceResult{
 			Contents: []*mcp.ResourceContents{
 				{
@@ -50,7 +50,7 @@ func main() {
 			"openai/toolInvocation/invoking": "Greeting...",
 			"openai/widgetAccessible":        true,
 		},
-	}, func(ctx context.Context, req *mcp.CallToolRequest, args args) (*mcp.CallToolResult, any, error) {
+	}, func(_ context.Context, _ *mcp.CallToolRequest, args args) (*mcp.CallToolResult, any, error) {
 		// Default to "Hi" if not specified
 		greetingType := args.GreetingType
 		if greetingType == "" {

docs/generator/reference/docker_mcp_server_init.yaml

@@ -0,0 +1,36 @@
+command: docker mcp server init
+short: Initialize a new MCP server project
+long: |
+    Initialize a new MCP server project in the specified directory with boilerplate code, Dockerfile, and compose.yaml
+usage: docker mcp server init <directory>
+pname: docker mcp server
+plink: docker_mcp_server.yaml
+options:
+    - option: language
+      value_type: string
+      default_value: go
+      description: |
+        Programming language for the server (currently only 'go' is supported)
+      deprecated: false
+      hidden: false
+      experimental: false
+      experimentalcli: false
+      kubernetes: false
+      swarm: false
+    - option: template
+      value_type: string
+      default_value: basic
+      description: Template to use (basic, chatgpt-app-basic)
+      deprecated: false
+      hidden: false
+      experimental: false
+      experimentalcli: false
+      kubernetes: false
+      swarm: false
+deprecated: false
+hidden: false
+experimental: false
+experimentalcli: false
+kubernetes: false
+swarm: false
+

docs/generator/reference/mcp_server_init.md

@@ -0,0 +1,15 @@
+# docker mcp server init
+
+<!---MARKER_GEN_START-->
+Initialize a new MCP server project in the specified directory with boilerplate code, Dockerfile, and compose.yaml
+
+### Options
+
+| Name         | Type     | Default | Description                                                            |
+|:-------------|:---------|:--------|:-----------------------------------------------------------------------|
+| `--language` | `string` | `go`    | Programming language for the server (currently only 'go' is supported) |
+| `--template` | `string` | `basic` | Template to use (basic, chatgpt-app-basic)                             |
+
+
+<!---MARKER_GEN_END-->
+