adding resource APIs

Signed-off-by: Jason Madigan <jason@jasonmadigan.com>

Author: jasonmadigan

README.md

@@ -140,6 +140,34 @@ Or if running the binary directly:
 }
 ```
 
+## Available Resources
+
+The MCP server provides comprehensive documentation and examples through resources:
+
+### Documentation Resources
+- `kuadrant://docs/gateway-api` - Gateway API overview and Kuadrant integration
+- `kuadrant://docs/dnspolicy` - Complete DNSPolicy reference with examples
+- `kuadrant://docs/ratelimitpolicy` - RateLimitPolicy patterns and advanced usage
+- `kuadrant://docs/authpolicy` - AuthPolicy authentication and authorization methods
+- `kuadrant://docs/tlspolicy` - TLSPolicy certificate management guide
+
+### Example Resources
+- `kuadrant://examples/basic-setup` - Simple API with rate limiting and API key auth
+- `kuadrant://examples/production-setup` - Full production setup with TLS, DNS, JWT auth
+
+### Troubleshooting
+- `kuadrant://troubleshooting` - Common issues, debugging techniques, and solutions
+
+Access these resources in Claude by asking questions like:
+- "Show me the Kuadrant rate limiting documentation"
+- "How do I set up production TLS with Kuadrant?"
+- "Help me troubleshoot my AuthPolicy not working"
+
+**Note**: Claude may not always use resources automatically. To ensure resource usage:
+- Be specific about wanting documentation or examples
+- Reference Kuadrant policies by name (e.g., "RateLimitPolicy", "AuthPolicy")
+- Ask for "complete examples" or "troubleshooting guide"
+
 ## Available Tools
 
 ### `create_gateway`
@@ -392,7 +420,7 @@ Using Docker (recommended):
     },
     "kubernetes": {
       "command": "npx",
-      "args": ["mcp-server-kubernetes"]
+      "args": ["@flux159/mcp-server-kubernetes"]
     }
   }
 }
@@ -407,7 +435,7 @@ Or using the binary directly:
     },
     "kubernetes": {
       "command": "npx",
-      "args": ["mcp-server-kubernetes"]
+      "args": ["@flux159/mcp-server-kubernetes"]
     }
   }
 }
@@ -420,7 +448,7 @@ Or using the binary directly:
 claude mcp add kuadrant /path/to/kuadrant-mcp-server -s user
 
 # Add Kubernetes server
-claude mcp add kubernetes npx mcp-server-kubernetes -s user
+claude mcp add kubernetes npx @flux159/mcp-server-kubernetes -s user
 ```
 
 ### Safe Mode
@@ -433,7 +461,7 @@ To prevent destructive operations, run the Kubernetes server in safe mode:
   "mcpServers": {
     "kubernetes": {
       "command": "npx",
-      "args": ["mcp-server-kubernetes"],
+      "args": ["@flux159/mcp-server-kubernetes"],
       "env": {
         "ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS": "true"
       }
@@ -442,7 +470,7 @@ To prevent destructive operations, run the Kubernetes server in safe mode:
 }
 
 # Or with Claude Code CLI:
-ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true npx mcp-server-kubernetes
+ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true npx @flux159/mcp-server-kubernetes
 ```
 
 ### Example Workflow

main.go

@@ -542,7 +542,7 @@ func main() {
 		),
 	)
 
-	// Add resources for Kuadrant documentation
+	// Add resources for Kuadrant documentation (from resources.go)
 	addKuadrantResources(server)
 
 	ctx := context.Background()
@@ -579,306 +579,3 @@ func main() {
 	}
 }
 
-// Resource handlers
-func gatewayAPIResourceHandler(ctx context.Context, ss *mcp.ServerSession, params *mcp.ReadResourceParams) (*mcp.ReadResourceResult, error) {
-	content := `# Gateway API and Kuadrant
-
-The Gateway API is a Kubernetes API for managing ingress traffic. Kuadrant extends the Gateway API with additional policies for:
-
-- DNS management (DNSPolicy)
-- TLS certificate management (TLSPolicy)
-- Rate limiting (RateLimitPolicy)
-- Authentication and authorization (AuthPolicy)
-
-## Enabling Kuadrant on a Gateway
-
-Add the annotation to your Gateway:
-  kuadrant.io/policy: enabled
-
-## Policy Attachment
-
-Policies attach to Gateway API resources:
-- Gateway: Affects all routes through the gateway
-- HTTPRoute: Affects specific routes
-`
-	return &mcp.ReadResourceResult{
-		Contents: []*mcp.ResourceContents{
-			{
-				URI:      params.URI,
-				MIMEType: "text/plain",
-				Text:     content,
-			},
-		},
-	}, nil
-}
-
-func dnsPolicyResourceHandler(ctx context.Context, ss *mcp.ServerSession, params *mcp.ReadResourceParams) (*mcp.ReadResourceResult, error) {
-	content := `# DNSPolicy
-
-DNSPolicy enables DNS management for Gateway API resources.
-
-## Specification
-
-apiVersion: kuadrant.io/v1
-kind: DNSPolicy
-
-Key fields:
-- targetRef: References a Gateway
-- providerRefs: DNS provider credentials
-- loadBalancing: Geographic and weighted load balancing
-- healthCheck: Endpoint health monitoring
-
-## Example: Multi-region DNS
-
-apiVersion: kuadrant.io/v1
-kind: DNSPolicy
-metadata:
-  name: multi-region-dns
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: Gateway
-    name: prod-gateway
-  providerRefs:
-  - name: aws-route53
-  loadBalancing:
-    geo: 
-      defaultGeo: true
-      zones:
-      - id: us-east-1
-        weight: 100
-      - id: eu-west-1
-        weight: 100
-  healthCheck:
-    endpoint: /health
-    interval: 30s
-    threshold: 3
-`
-	return &mcp.ReadResourceResult{
-		Contents: []*mcp.ResourceContents{
-			{
-				URI:      params.URI,
-				MIMEType: "text/plain",
-				Text:     content,
-			},
-		},
-	}, nil
-}
-
-func rateLimitPolicyResourceHandler(ctx context.Context, ss *mcp.ServerSession, params *mcp.ReadResourceParams) (*mcp.ReadResourceResult, error) {
-	content := `# RateLimitPolicy
-
-RateLimitPolicy provides fine-grained rate limiting for APIs.
-
-## Specification
-
-apiVersion: kuadrant.io/v1
-kind: RateLimitPolicy
-
-Key concepts:
-- limits: Named rate limit definitions
-- when: Conditions for applying limits
-- counters: What to count (requests, unique users, etc.)
-
-## Example: API Rate Limiting
-
-apiVersion: kuadrant.io/v1
-kind: RateLimitPolicy
-metadata:
-  name: api-limits
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: api-route
-  limits:
-    per_user:
-      rates:
-      - limit: 100
-        window: 60s
-      counters:
-      - auth.identity.userid
-    per_ip:
-      rates:
-      - limit: 1000
-        window: 60s
-      counters: 
-      - request.headers.x-forwarded-for
-
-## Selector Syntax
-
-when:
-- predicate: request.path == "/api/v1/expensive"
-  limits:
-    expensive_endpoint:
-      rates:
-      - limit: 10
-        window: 60s
-`
-	return &mcp.ReadResourceResult{
-		Contents: []*mcp.ResourceContents{
-			{
-				URI:      params.URI,
-				MIMEType: "text/plain",
-				Text:     content,
-			},
-		},
-	}, nil
-}
-
-func authPolicyResourceHandler(ctx context.Context, ss *mcp.ServerSession, params *mcp.ReadResourceParams) (*mcp.ReadResourceResult, error) {
-	content := `# AuthPolicy
-
-AuthPolicy provides authentication and authorization for APIs.
-
-## Specification
-
-apiVersion: kuadrant.io/v1
-kind: AuthPolicy
-
-Key sections:
-- authentication: Identity verification (JWT, API keys, etc.)
-- authorization: Access control (OPA, simple patterns)
-- response: Custom response handling
-
-## Example: JWT Authentication with RBAC
-
-apiVersion: kuadrant.io/v1
-kind: AuthPolicy
-metadata:
-  name: api-auth
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: HTTPRoute
-    name: api-route
-  rules:
-    authentication:
-      jwt:
-        jwt:
-          issuerUrl: https://auth.example.com
-          audiences:
-          - api.example.com
-    authorization:
-      opa:
-        rego: |
-          allow = true {
-            input.auth.identity.realm_access.roles[_] == "api-user"
-          }
-    response:
-      unauthorized:
-        headers:
-          WWW-Authenticate: Bearer realm="api"
-        body: "Unauthorized"
-        code: 401
-`
-	return &mcp.ReadResourceResult{
-		Contents: []*mcp.ResourceContents{
-			{
-				URI:      params.URI,
-				MIMEType: "text/plain",
-				Text:     content,
-			},
-		},
-	}, nil
-}
-
-func tlsPolicyResourceHandler(ctx context.Context, ss *mcp.ServerSession, params *mcp.ReadResourceParams) (*mcp.ReadResourceResult, error) {
-	content := `# TLSPolicy
-
-TLSPolicy automates TLS certificate management for Gateways.
-
-## Specification
-
-apiVersion: kuadrant.io/v1alpha1
-kind: TLSPolicy
-
-Integrates with cert-manager for certificate lifecycle management.
-
-## Example: Let's Encrypt Wildcard Certificate
-
-apiVersion: kuadrant.io/v1alpha1
-kind: TLSPolicy
-metadata:
-  name: wildcard-tls
-spec:
-  targetRef:
-    group: gateway.networking.k8s.io
-    kind: Gateway
-    name: prod-gateway
-  issuerRef:
-    group: cert-manager.io
-    kind: ClusterIssuer
-    name: letsencrypt-prod
-  commonName: "*.example.com"
-  duration: 90d
-  renewBefore: 30d
-  dnsNames:
-  - "*.example.com"
-  - "example.com"
-  secretTemplate:
-    annotations:
-      kuadrant.io/tlspolicy: wildcard-tls
-`
-	return &mcp.ReadResourceResult{
-		Contents: []*mcp.ResourceContents{
-			{
-				URI:      params.URI,
-				MIMEType: "text/plain",
-				Text:     content,
-			},
-		},
-	}, nil
-}
-
-// addKuadrantResources adds MCP resources for Kuadrant documentation
-func addKuadrantResources(server *mcp.Server) {
-	// Add resources
-	server.AddResources(
-		&mcp.ServerResource{
-			Resource: &mcp.Resource{
-				URI:         "kuadrant://docs/gateway-api",
-				Name:        "Gateway API Overview",
-				Description: "Overview of Gateway API and Kuadrant integration",
-				MIMEType:    "text/plain",
-			},
-			Handler: gatewayAPIResourceHandler,
-		},
-		&mcp.ServerResource{
-			Resource: &mcp.Resource{
-				URI:         "kuadrant://docs/dnspolicy",
-				Name:        "DNSPolicy Reference",
-				Description: "DNSPolicy specification and examples",
-				MIMEType:    "text/plain",
-			},
-			Handler: dnsPolicyResourceHandler,
-		},
-		&mcp.ServerResource{
-			Resource: &mcp.Resource{
-				URI:         "kuadrant://docs/ratelimitpolicy",
-				Name:        "RateLimitPolicy Reference",
-				Description: "RateLimitPolicy specification and examples",
-				MIMEType:    "text/plain",
-			},
-			Handler: rateLimitPolicyResourceHandler,
-		},
-		&mcp.ServerResource{
-			Resource: &mcp.Resource{
-				URI:         "kuadrant://docs/authpolicy",
-				Name:        "AuthPolicy Reference",
-				Description: "AuthPolicy specification and examples",
-				MIMEType:    "text/plain",
-			},
-			Handler: authPolicyResourceHandler,
-		},
-		&mcp.ServerResource{
-			Resource: &mcp.Resource{
-				URI:         "kuadrant://docs/tlspolicy",
-				Name:        "TLSPolicy Reference",
-				Description: "TLSPolicy specification and examples",
-				MIMEType:    "text/plain",
-			},
-			Handler: tlsPolicyResourceHandler,
-		},
-	)
-}