Хост предоставляет дескриптор файла. Запустите задачу один раз, сохраните её идентификатор и запрашивайте состояние и выходные файлы этой же задачи. Ниже приведён иллюстративный запрос и ответ, а не выполняющаяся задача.
MCP: start_sheet_music_conversion + get_sheet_music_conversion
MCP-хост передаёт прикреплённые ноты в виде дескриптора файла. start_sheet_music_conversion отправляет задачу, а get_sheet_music_conversion получает её статус и выходные файлы.
PDF, PNG, JPG → MIDI, MXL
Параметры
file — дескриптор файла, предоставленный хостомoutput_formats — запрошенные форматы, например ["midi", "mxl"]preprocess — необязательная подготовка прикреплённых нот
// 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://..."}
]
}