claude tool setup

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

Author: jasonmadigan

README.md

@@ -2,6 +2,25 @@
 
 A Model Context Protocol (MCP) server that generates Kuadrant policy manifests in YAML format. Designed to work alongside Kubernetes MCP servers like [k8s-mcp-server](https://github.com/reza-gholizade/k8s-mcp-server) or [mcp-kubernetes](https://mcp.so/server/mcp-kubernetes/) for applying resources to clusters.
 
+## Quick Start (Claude Code CLI)
+
+```bash
+# Clone and build
+git clone https://github.com/jasonmadigan/kuadrant-mcp-server
+cd kuadrant-mcp-server
+go build -o kuadrant-mcp-server
+
+# Add to Claude Code (project-scoped)
+claude mcp add kuadrant ./kuadrant-mcp-server
+
+# Or add for your user (available in all projects)
+claude mcp add kuadrant $(pwd)/kuadrant-mcp-server -s user
+
+# Verify and use
+claude mcp list
+claude  # Start new session, type /mcp to see available servers
+```
+
 ## Overview
 
 This MCP server generates Kuadrant-specific Kubernetes manifests:
@@ -32,25 +51,56 @@ docker build -t kuadrant-mcp-server:latest .
 
 ## Usage
 
+### Transport Options
+
+The server supports multiple transport protocols:
+
+1. **stdio** (default) - Standard input/output for CLI integration
+2. **sse** - Server-Sent Events for web-based clients
+3. **http** - Streamable HTTP for modern web applications
+
 ### Standalone
+
+#### Using stdio transport (default)
 ```bash
 kuadrant-mcp-server
 ```
 
+#### Using SSE transport
+```bash
+kuadrant-mcp-server -transport sse -addr :8080
+```
+
+#### Using StreamableHTTP transport
+```bash
+kuadrant-mcp-server -transport http -addr :8080
+```
+
 ### With Docker
+
+#### stdio transport
 ```bash
 docker run -i --rm ghcr.io/jasonmadigan/kuadrant-mcp-server:latest
 ```
 
+#### SSE transport
+```bash
+docker run -i --rm -p 8080:8080 ghcr.io/jasonmadigan/kuadrant-mcp-server:latest -transport sse -addr :8080
+```
+
+#### StreamableHTTP transport
+```bash
+docker run -i --rm -p 8080:8080 ghcr.io/jasonmadigan/kuadrant-mcp-server:latest -transport http -addr :8080
+```
+
 ### With Docker Compose
 ```bash
 docker-compose up
 ```
 
 ### MCP Client Configuration
 
-Add to your MCP client configuration:
-
+#### For stdio transport (Claude Desktop, CLI tools)
 ```json
 {
   "mcpServers": {
@@ -62,6 +112,18 @@ Add to your MCP client configuration:
 }
 ```
 
+#### For HTTP transports (web applications)
+```json
+{
+  "mcpServers": {
+    "kuadrant-mcp": {
+      "url": "http://localhost:8080",
+      "transport": "streamablehttp"  // or "sse" for SSE transport
+    }
+  }
+}
+```
+
 ## Available Tools
 
 ### `create_gateway`
@@ -443,6 +505,141 @@ docker-compose build
 docker-compose run --rm kuadrant-mcp
 ```
 
+## Claude Code CLI Setup
+
+To use this server with Claude Code CLI:
+
+1. **Build the server**
+   ```bash
+   go build -o kuadrant-mcp-server
+   ```
+
+2. **Add to Claude Code**
+   ```bash
+   claude mcp add kuadrant /path/to/kuadrant-mcp-server
+   ```
+
+   For example:
+   ```bash
+   claude mcp add kuadrant /Users/yourusername/kuadrant-mcp-server/kuadrant-mcp-server
+   ```
+
+3. **Verify installation**
+   ```bash
+   claude mcp list
+   ```
+
+4. **Test in Claude**
+   Start a new Claude session and type:
+   ```
+   /mcp
+   ```
+   
+   You should see "kuadrant" listed. Then try:
+   ```
+   Create a Gateway manifest named 'test-gateway' in namespace 'default'
+   ```
+
+### Troubleshooting
+
+If `/mcp` shows "No MCP servers configured":
+- Make sure you're in the same directory where you ran `claude mcp add` (for project/local scope)
+- The MCP configuration scopes are:
+  - `local`: Private to you in the current project (default)
+  - `user`: Available to you in all projects
+  - `project`: Shared with all users in the current project
+- Try adding with the full absolute path
+- Check the server is executable: `chmod +x kuadrant-mcp-server`
+- Start a new Claude session after adding the server
+
+### Enable Logging (Optional)
+
+To see when Claude uses your MCP server:
+
+1. Use the logging wrapper script:
+   ```bash
+   chmod +x run_with_logging.sh
+   claude mcp remove kuadrant -s local
+   claude mcp add kuadrant /path/to/kuadrant-mcp-server/run_with_logging.sh
+   ```
+
+2. Monitor the logs:
+   ```bash
+   tail -f /tmp/kuadrant-mcp.log
+   ```
+
+### Testing Your Installation
+
+After setting up the MCP server, test it with these commands in Claude:
+
+1. **Verify MCP tools are available** in Claude:
+   ```
+   /mcp
+   ```
+   
+   You should see "kuadrant" listed. Then check what tools it provides:
+   ```
+   What tools does the kuadrant MCP server provide?
+   ```
+
+2. **Monitor the logs** (in a separate terminal):
+   ```bash
+   tail -f /tmp/kuadrant-mcp.log
+   ```
+
+3. **Test basic commands** in Claude:
+
+   ```
+   # Basic Gateway creation
+   Use the kuadrant MCP server's create_gateway tool to generate a manifest with name 'api-gateway' in namespace 'production'
+
+   # HTTPRoute creation
+   Use the create_httproute tool to generate a manifest for route 'api-route' in namespace 'production' with parentRef to gateway 'api-gateway'
+
+   # Rate limiting policy
+   Use the create_ratelimitpolicy tool to generate a policy that limits to 100 requests per minute for HTTPRoute 'api-route' in namespace 'production'
+
+   # Authentication policy
+   Use the create_authpolicy tool for JWT authentication on HTTPRoute 'api-route' in namespace 'production'
+
+   # DNS policy
+   Use the create_dnspolicy tool for gateway 'api-gateway' in namespace 'production' with providerRef name 'aws-route53'
+
+   # TLS policy
+   Use the create_tlspolicy tool for gateway 'api-gateway' with issuerRef 'letsencrypt-prod' in namespace 'production'
+   ```
+
+   Or use even more explicit commands:
+   ```
+   Please call the kuadrant MCP server's create_gateway tool with these arguments:
+   - name: "api-gateway"
+   - namespace: "production"
+   - gatewayClassName: "istio"
+   - kuadrantEnabled: true
+   ```
+
+4. **Test a complete setup**:
+   ```
+   Using the kuadrant MCP tools, please:
+   1. Call create_gateway for a Gateway named 'prod-api' in namespace 'production'
+   2. Call create_httproute for route 'api-routes' routing to 'prod-api' 
+   3. Call create_ratelimitpolicy with 1000 requests per hour limit
+   4. Call create_authpolicy for JWT authentication
+   ```
+
+5. **What you should see in the logs**:
+   ```
+   [KUADRANT MCP] Starting server with transport=stdio
+   [KUADRANT MCP] create_gateway called with name=api-gateway, namespace=production
+   [KUADRANT MCP] create_httproute called with name=api-route, namespace=production
+   [KUADRANT MCP] create_ratelimitpolicy called with name=api-route, namespace=production
+   ```
+
+If you don't see logs:
+- Type `/mcp` in Claude - verify "kuadrant" is listed
+- Make sure you started a new Claude session after adding the server
+- Try being more explicit: "Use the kuadrant MCP server to create a Gateway"
+
 ## MCP Configuration
 
 To use this server with an MCP client (like Claude Desktop), add it to your MCP configuration:

go.mod

@@ -1,6 +1,8 @@
 module github.com/jasonmadigan/kuadrant-mcp-server
 
-go 1.23
+go 1.23.0
+
+toolchain go1.24.3
 
 require (
 	github.com/modelcontextprotocol/go-sdk v0.1.0