Merge pull request #13 from redhat-ai-tools/prompt

Add prompt providing a workflow for ROSA HCP Cluster pre-req guidance

Author: tiwillia

README.md

@@ -64,10 +64,6 @@ Flags:
   --transport string      transport mode (stdio/sse) (default "stdio")
 ```
 
-### Environment Variables
-
-- `OCM_OFFLINE_TOKEN`: Your OCM offline token for authentication - only used in stdio transport
-
 ### TOML Configuration File
 
 ```toml
@@ -81,6 +77,8 @@ sse_base_url = "https://example.com:8080"
 
 ### Stdio Transport (Local)
 
+Stdio transport requires the `OCM_OFFLINE_TOKEN` environment variable for authentication.
+
 ```bash
 # Set your OCM token
 export OCM_OFFLINE_TOKEN="your-ocm-token-here"
@@ -91,14 +89,16 @@ export OCM_OFFLINE_TOKEN="your-ocm-token-here"
 
 ### SSE Transport (Remote)
 
+SSE transport uses header-based authentication with the `X-OCM-OFFLINE-TOKEN` header. No environment variables required.
+
 ```bash
 # Start SSE server
 ./rosa-mcp-server --transport=sse --port=8080
 
 # Server will be available at:
 # - SSE stream: http://localhost:8080/sse
 # - MCP messages: http://localhost:8080/message
-# Send X-OCM-OFFLINE-TOKEN header with requests
+# Authentication: Send X-OCM-OFFLINE-TOKEN header with requests
 ```
 
 ## Authentication Setup
@@ -264,7 +264,9 @@ make undeploy           # Remove from OpenShift
 
 ## Integration with AI Assistants
 
-Add to your mcpServers list:
+### Stdio Transport Configuration
+
+For local stdio-based integration:
 
 ```json
 {
@@ -280,19 +282,21 @@ Add to your mcpServers list:
 }
 ```
 
-### SSE Integration
+### SSE Transport Configuration
 
-For remote integrations, use the SSE endpoints:
+For remote SSE-based integration (no environment variables needed):
 
-```bash
-# SSE stream endpoint (for Server-Sent Events)
-GET http://localhost:8080/sse
-
-# MCP message endpoint (for sending JSON-RPC messages)
-POST http://localhost:8080/message
-
-# Required header for both endpoints
-X-OCM-OFFLINE-TOKEN: your-token-here
+```json
+{
+  "mcpServers": {
+    "rosa-hcp": {
+      "url": "http://your-server:8080/sse",
+      "headers": {
+        "X-OCM-OFFLINE-TOKEN": "your-token-here"
+      }
+    }
+  }
+}
 ```
 
 ## Error Handling

pkg/mcp/prompts.go

@@ -0,0 +1,41 @@
+package mcp
+
+import (
+	"context"
+	_ "embed"
+
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+//go:embed prompts/rosa-hcp-prerequisites-guide.md
+var prereqsGuide string
+
+// registerPrompts registers all MCP prompts with the server
+func (s *Server) registerPrompts() {
+	// ROSA HCP Prerequisites Guide prompt
+	s.mcpServer.AddPrompt(mcp.NewPrompt("rosa_hcp_prerequisites_guide",
+		mcp.WithPromptDescription("Comprehensive guidance on ROSA HCP cluster creation prerequisites and setup steps"),
+	), s.handleROSAHCPPrereqsPrompt)
+}
+
+// handleROSAHCPPrereqsPrompt provides comprehensive ROSA HCP prerequisites guidance as a prompt
+func (s *Server) handleROSAHCPPrereqsPrompt(ctx context.Context, request mcp.GetPromptRequest) (*mcp.GetPromptResult, error) {
+	return mcp.NewGetPromptResult(
+		"ROSA HCP Prerequisites Guide",
+		[]mcp.PromptMessage{
+			mcp.NewPromptMessage(
+				mcp.RoleUser,
+				mcp.NewTextContent(prereqsGuide),
+			),
+			mcp.NewPromptMessage(
+				mcp.RoleUser,
+				mcp.NewResourceLink(
+					"https://cloud.redhat.com/learning/learn:getting-started-red-hat-openshift-service-aws-rosa/resource/resources:creating-rosa-hcp-clusters-using-default-options#page-title",
+					"ROSA HCP Documentation",
+					"Official Red Hat documentation for creating ROSA HCP clusters using default options",
+					"text/html",
+				),
+			),
+		},
+	), nil
+}