Nimbus Copiloto — MCP-Server des Helpdesks

MCP-Server für Helpdesk Nimbus, die Support-Ticket-Plattform von Nimbus S.A.S. Er ermöglicht es einem KI-Assistenten, das Helpdesk zu bedienen: Fälle suchen, Verlauf abrufen, eskalieren, antworten und SLA-Einhaltung messen.

Dies ist eine Lernumgebung. Nimbus S.A.S. ist ein fiktives Unternehmen. Das Repository existiert, um FastMCP zu lernen, indem man ein Projekt mit der Form und den Anforderungen eines realen Projekts aufbaut.

Schnellstart

# 1. Dependencias
uv sync

# 2. Sembrar la base de datos
uv run python -m backend.seed

# 3. Levantar el backend de la empresa (terminal aparte, déjalo corriendo)
uv run uvicorn backend.main:app --reload --port 8000

# 4. Correr las pruebas
uv run pytest -v

Mit laufendem Backend: http://127.0.0.1:8000/docs

Related MCP server: tickiti-mcp

Der MCP-Server

# Correrlo
uv run python -m nimbus_mcp.server

# Inspeccionarlo en el navegador
uv run fastmcp dev src/nimbus_mcp/server.py

Er ist auch innerhalb von Claude Code über .mcp.json verfügbar. Mit /mcp überprüfen.

Struktur

mcp-test/
├── backend/              # API interna de Nimbus — NO SE TOCA
│   ├── main.py           #   FastAPI: tickets, clientes, agentes, KB, métricas
│   ├── db.py             #   Esquema SQLite
│   └── seed.py           #   Generador de datos de prueba
├── src/nimbus_mcp/       # El servidor MCP — aquí trabajas
│   └── server.py
├── tests/                # Pruebas
├── data/nimbus.db        # Base sembrada (regenerable)
└── docs/                 # Documentación del proyecto

Dokumentation

Der Plan

Dieses Repository ist Phase 1 von acht. Das System wächst schichtweise: MCP → Copilot → Evals → RAG → Guardrails → Observability → eigene Modelle → Produktion. Die vollständige Roadmap befindet sich in docs/RUTA_AI_ENGINEER.md.

Versionen

Python 3.13 · FastMCP 3.4.7 · FastAPI 0.141 · pytest 9.1