Operations MCP Server

Un Enterprise Operations Assistant costruito con MCP (Model Context Protocol), Java e Spring Boot.

🚀 Caratteristiche

Questo server MCP espone tool per il monitoraggio delle operazioni enterprise:

• getSystemMetrics - Recupera metriche di sistema in tempo reale (latenza, tasso di errore, timestamp)
• getRecentIncidents - Recupera la lista degli incidenti recenti con dettagli completi

📋 Prerequisiti

• Java 25 o superiore
• Maven 3.6+ (incluso Maven Wrapper)

🔧 Setup Rapido

Windows

# Esegui lo script batch per compilare e avviare
.\run.bat

Linux/macOS

# Compila
./mvnw clean package

# Esegui
./mvnw spring-boot:run

🛠️ Tool Disponibili

1. getSystemMetrics

Recupera le metriche di sistema correnti.

Output esempio:

{
  "avgLatencyMs": 120,
  "errorRate": 0.02,
  "timestamp": "2026-02-11T10:30:00Z"
}

2. getRecentIncidents

Recupera gli incidenti recenti del sistema.

Output esempio:

[
  {
    "id": "INC-42",
    "title": "Database latency spike",
    "timestamp": "2026-02-11T09:30:00Z",
    "status": "Resolved"
  },
  {
    "id": "INC-43",
    "title": "Cache eviction anomaly",
    "timestamp": "2026-02-11T08:30:00Z",
    "status": "Investigating"
  }
]

🔌 Integrazione con Claude Desktop

Aggiungi questa configurazione al file di configurazione di Claude:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "operations-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "/percorso/completo/al/operations-mcp-server/target/operations-mcp-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

Riavvia Claude Desktop per attivare i tool.

📚 Documentazione

Per maggiori dettagli, consulta USAGE.md.

🏗️ Struttura del Progetto

operations-mcp-server/
├── src/main/java/it/matteoroxis/operations_mcp_server/
│   ├── OperationsMcpServerApplication.java    # Main application
│   ├── component/
│   │   └── MonitoringTools.java               # Tool MCP implementati
│   ├── configuration/
│   │   └── McpServerConfiguration.java        # Configurazione MCP
│   └── model/
│       ├── Incident.java                      # Modello Incident
│       └── SystemMetrics.java                 # Modello SystemMetrics
└── src/main/resources/
    └── application.properties                 # Configurazione Spring

🔑 Tecnologie Utilizzate

• Spring Boot 3.5.10 - Framework applicativo
• Spring AI 1.1.2 - Integrazione MCP Server
• Java 25 - Linguaggio di programmazione
• Maven - Build tool

📝 Licenza

Questo progetto è fornito "as-is" senza alcuna garanzia.