Ứng dụng cung cấp mô tả tệp. Chỉ khởi chạy tác vụ một lần, giữ mã định danh rồi truy vấn chính tác vụ đó để lấy trạng thái và các tệp được tạo. Yêu cầu và phản hồi bên dưới chỉ để minh họa, không phải tác vụ đang chạy.
MCP: start_sheet_music_conversion + get_sheet_music_conversion
Ứng dụng MCP truyền bản nhạc đính kèm dưới dạng mô tả tệp. start_sheet_music_conversion gửi tác vụ; get_sheet_music_conversion lấy trạng thái và các tệp đầu ra.
PDF, PNG, JPG → MIDI, MXL
Tham số
file — mô tả tệp do máy chủ cung cấpoutput_formats — định dạng đầu ra yêu cầu, ví dụ ["midi", "mxl"]preprocess — chuẩn bị tùy chọn cho bản nhạc đã đính kèm
// 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://..."}
]
}