Initial commit: LLM Automation Docs & Remediation Engine v2.0
Features: - Automated datacenter documentation generation - MCP integration for device connectivity - Auto-remediation engine with safety checks - Multi-factor reliability scoring (0-100%) - Human feedback learning loop - Pattern recognition and continuous improvement - Agentic chat support with AI - API for ticket resolution - Frontend React with Material-UI - CI/CD pipelines (GitLab + Gitea) - Docker & Kubernetes deployment - Complete documentation and guides v2.0 Highlights: - Auto-remediation with write operations (disabled by default) - Reliability calculator with 4-factor scoring - Human feedback system for continuous learning - Pattern-based progressive automation - Approval workflow for critical actions - Full audit trail and rollback capability
This commit is contained in:
93
docs/api/mcp.md
Normal file
93
docs/api/mcp.md
Normal file
@@ -0,0 +1,93 @@
|
||||
# MCP Server Documentation
|
||||
|
||||
Il MCP (Model Context Protocol) Server fornisce metodi per LLM per connettersi e recuperare dati dalle infrastrutture.
|
||||
|
||||
## Base URL
|
||||
|
||||
```
|
||||
https://docs.datacenter.local/mcp
|
||||
```
|
||||
|
||||
## Metodi Disponibili
|
||||
|
||||
### GET /methods
|
||||
|
||||
Lista tutti i metodi disponibili con descrizione e parametri.
|
||||
|
||||
### GET /connections
|
||||
|
||||
Lista connessioni configurate (senza credenziali).
|
||||
|
||||
## Execution Endpoints
|
||||
|
||||
### POST /execute/ssh
|
||||
|
||||
Esegui comando SSH su device.
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"connection_name": "switch-core-01",
|
||||
"command": "show version"
|
||||
}
|
||||
```
|
||||
|
||||
### POST /execute/snmp/get
|
||||
|
||||
Query SNMP GET su OID specifico.
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"connection_name": "ups-01",
|
||||
"oid": ".1.3.6.1.2.1.33.1.2.1.0"
|
||||
}
|
||||
```
|
||||
|
||||
### POST /execute/api
|
||||
|
||||
Esegui richiesta API REST.
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"connection_name": "vcenter-prod",
|
||||
"endpoint": "/rest/vcenter/vm",
|
||||
"method": "GET"
|
||||
}
|
||||
```
|
||||
|
||||
## Esempi
|
||||
|
||||
### Python con MCP
|
||||
```python
|
||||
import asyncio
|
||||
from mcp_client import MCPClient
|
||||
|
||||
async def get_infrastructure_data():
|
||||
client = MCPClient('https://docs.datacenter.local/mcp')
|
||||
|
||||
# Get VMware VMs
|
||||
vms = await client.vmware_get_vms('vcenter-prod')
|
||||
|
||||
# Get switch config
|
||||
config = await client.cisco_get_interfaces('switch-core-01')
|
||||
|
||||
# Get UPS status
|
||||
ups_status = await client.ups_get_status('ups-01')
|
||||
|
||||
return {
|
||||
'vms': vms,
|
||||
'network': config,
|
||||
'power': ups_status
|
||||
}
|
||||
|
||||
data = asyncio.run(get_infrastructure_data())
|
||||
```
|
||||
|
||||
## Security
|
||||
|
||||
- Accesso limitato a rete management
|
||||
- Read-only operations only
|
||||
- Audit logging completo
|
||||
- Rate limiting per connessione
|
||||
Reference in New Issue
Block a user