L’host fornisce il descrittore del file. Avvia l’attività una volta, conserva il suo identificatore e interroga la stessa attività per ottenere stato e file prodotti. La richiesta e la risposta seguenti sono illustrative, non un’attività in esecuzione.
MCP: start_sheet_music_conversion + get_sheet_music_conversion
Il tuo host MCP trasmette lo spartito allegato come descrittore del file. start_sheet_music_conversion invia l’attività; get_sheet_music_conversion ne recupera lo stato e i file di output.
PDF, PNG, JPG → MIDI, MXL
Parametri
file — descrittore del file fornito dall’hostoutput_formats — output richiesti, ad esempio ["midi", "mxl"]preprocess — preparazione facoltativa dello spartito allegato
// MCP Tool Call (handled automatically by your AI agent)
{
"tool": "start_sheet_music_conversion",
"arguments": {
"file": {
"file_id": "host_uploaded_score_123",
"download_url": "https://host.example/files/score.pdf",
"file_name": "score.pdf",
"mime_type": "application/pdf"
},
"client_request_id": "chatgpt-score-0001",
"output_formats": ["midi", "mxl"]
}
}
// Poll until the job is complete
{
"tool": "get_sheet_music_conversion",
"arguments": {"task_id": "task_abc123456789"}
}
// Completed response (abridged)
{
"task_id": "task_abc123456789",
"status": "succeeded",
"artifacts": [
{"type": "midi", "file_name": "score.mid", "download_url": "https://..."},
{"type": "mxl", "file_name": "score.mxl", "download_url": "https://..."}
]
}