EsempioscriptadvancedEseguibileguided-flow
Server
Esempio rieseguibile advanced di tipo script che usa mcp.
Fatti chiave
- Livello
- advanced
- Runtime
- Python • Mcp
- Pattern
- Flusso ispezionabile con confini di sistema visibili
- Interazione
- Sandbox live • Script
- Aggiornato
- 14 marzo 2026
Naviga questo esempio
Libreria
Sfoglia gli esempiRiapri la libreria completa per confrontare pattern vicini e percorsi collegati.Interazione
Esegui ora nel sandboxProva l'interazione direttamente nella superficie guidata di questo esempio.Sorgente
Apri codice completoLeggi l'implementazione reale, i punti evidenziati e i requisiti runtime.MCP
Chiama via MCPUsa la stessa risorsa dentro agenti, export deterministici e setup MCP.
Principi collegati
server.py
python
# /// script
# requires-python = ">=3.12"
# dependencies = [
# "mcp[cli]>=1.12.3",
# "pydantic>=2.11.7",
# "python-dotenv>=1.1.1",
# "requests>=2.32.4",
# "youtube-transcript-api>=1.2.2",
# ]
# ///
from mcp.server.fastmcp import FastMCP
from src.service import YouTubeTranscriptService
mcp = FastMCP(
name="YouTube",
stateless_http=True,
)
_service = YouTubeTranscriptService(use_proxy=True)
@mcp.tool()
def get_transcript(
video_url_or_id: str,
) -> str:
"""Get transcript as plain text."""
try:
return _service.get_transcript_text(video_url_or_id)
except Exception as e:
return f"Error: {str(e)}"
if __name__ == "__main__":
mcp.run(transport="stdio")
Principi correlati
- P6visibilityEsporre uno stato operativo significativo, non la complessità internaPresentare lo stato del sistema in linguaggio e strutture rilevanti per l'utente, piuttosto che esporre dettagli interni di basso livello che non supportano l'azione o la comprensione.Apri il principio →
- P7trustStabilire fiducia attraverso l'ispezionabilitàGli utenti dovrebbero essere in grado di esaminare come è stato prodotto un risultato quando la fiducia, la responsabilità o la qualità della decisione sono importanti.Apri il principio →
- P8trustRendere espliciti i passaggi, le approvazioni e i blocchiQuando il sistema non può procedere, la ragione dovrebbe essere immediatamente visibile, insieme a qualsiasi azione richiesta dall'utente o da un'altra dipendenza.Apri il principio →
- P9orchestrationRappresentare il lavoro delegato come un sistema, non solo come una conversazioneDove il lavoro coinvolge più passaggi, agenti, dipendenze o attività concorrenti, dovrebbe essere rappresentato come un sistema strutturato piuttosto che solo come un flusso di messaggi.Apri il principio →