Westfield Spring Boot Standards - MCP Server

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

Quick Start

uv sync
uv run context_server.py --transport sse

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

Docker Deployment

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

Developer Configuration

Add .mcp.json to your project:

Local:

{
  "mcpServers": {
    "westfield-standards": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Behind Gravitee:

{
  "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

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