# Westfield Spring Boot Standards - MCP Server

MCP server that serves Spring Boot development standards to Claude Code.

## Quick Start

```bash
uv sync
uv run context_server.py --transport sse
```

**SSE Endpoint:** `http://localhost:8000/sse`

## Docker Deployment

```bash
docker build -t westfield-springboot-standards .
docker run -p 8000:8000 westfield-springboot-standards
```

## Developer Configuration

Add `.mcp.json` to your project:

**Local:**
```json
{
  "mcpServers": {
    "westfield-standards": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

**Behind Gravitee:**
```json
{
  "mcpServers": {
    "westfield-standards": {
      "url": "https://api.yourcompany.com/mcp/springboot/sse"
    }
  }
}
```

## Endpoints

| Path | Purpose |
|------|---------|
| `/sse` | MCP SSE endpoint for Claude Code |
| `/health` | Health check for Kubernetes probes |

## Kubernetes Deployment

```yaml
livenessProbe:
  httpGet:
    path: /health
    port: 8000
readinessProbe:
  httpGet:
    path: /health
    port: 8000
```

## Gravitee Gateway Setup

Route `/mcp/springboot/sse` → `http://backend:8000/sse`

**Important:** Configure for SSE (Server-Sent Events):
- Disable request timeout or set very high
- Disable response buffering
- Enable keep-alive

## Available Resources

### Quick Start
| Resource | Description |
|----------|-------------|
| `standards://getting-started` | Condensed guide for new developers |

### Core Standards
| Resource | Description |
|----------|-------------|
| `standards://main` | Main instructions (intro.md) |
| `standards://intro` | Package structure guide |
| `standards://controller` | REST controller patterns |
| `standards://service` | Service layer patterns |
| `standards://dto` | DTO patterns |
| `standards://restclient` | External API integration |

### Enterprise Standards
| Resource | Description |
|----------|-------------|
| `standards://observability` | Tracing, metrics, logging |
| `standards://error-handling` | Error responses |
| `standards://performance` | Caching, pooling, async |

### Resilience (full or focused)
| Resource | Description |
|----------|-------------|
| `standards://resilience` | Full resilience guide |
| `standards://resilience-circuitbreaker` | Circuit breaker patterns |
| `standards://resilience-retry` | Retry patterns |
| `standards://resilience-bulkhead` | Bulkhead isolation |

### Testing (full or focused)
| Resource | Description |
|----------|-------------|
| `standards://testing` | Full testing guide |
| `standards://testing-unit` | Unit test patterns |
| `standards://testing-integration` | WireMock, TestContainers |
| `standards://testing-contract` | Pact contract testing |

## Tools

- `list_standards()` - List all available standards
- `search_standards(query)` - Search for a keyword
- `get_quick_reference()` - Quick reference card