Melogen / MCP

歌曲分析 — ChatGPT 與 MCP

直接附加 MP3、WAV、FLAC、OGG 或 M4A 音訊。OAuth 將 Melogen 連線到 MCP 主機，產生結構化分析。

使用 OAuth 連線

直接附加音訊，並請 AI 啟動分析。

MP3, WAV, FLAC, OGG, M4A12 個結構化視圖

帶上一首歌，決定要看什麼。

在 MCP 主機裡連上 Melogen，附加音訊，再提出一個音樂問題。

  • 用 OAuth 連線

    使用支援 Melogen MCP 連線和檔案附件的主機。依照連線說明登入並授權，然後再讓它分析音訊。

  • 附上真正的音訊

    附加 MP3、WAV、FLAC、OGG 或 M4A。檔案描述由主機提供；只寫歌名不算音訊附件。

  • 選擇報告語言

    可以要求英文或簡體中文報告。report_locale 參數決定分析語言。

使用方式

直接附加 MP3、WAV、FLAC、OGG 或 M4A 音訊。OAuth 將 Melogen 連線到 MCP 主機，產生結構化分析。

  1. 設定 MCP

    使用 OAuth 連線

  2. 詢問您的 AI

    直接附加音訊，並請 AI 啟動分析。 start_song_analysis.

  3. 取得分析

    get_song_analysis — 查詢任務狀態並取得結果。 分析成功且解鎖後，可用 ask_about_song 根據結果繼續追問。

從幾個角度看這首歌。

先看概覽，再進入和你的問題有關的部分。下面的圖是示意，不是分析結果。

順著編曲往下看

段落時間、標籤、樂器變化和編曲說明幫你在報告裡定位。請對照音訊核對段落邊界；時間和解讀都可能不確定。

看和聲和律動

查看估計的調中心、段落和聲、脈衝、鼓和貝斯的角色。這些是帶有信心說明的分析觀察，不是逐音記譜。

談情緒和製作

順著情緒和能量變化，看音色、動態、聲像和效果。把報告當作聆聽嚮導，並留意它標出的限制。

問一個具體的問題。

附上你自己的音訊之後，可以改寫這些示例請求。

畫出歌曲地圖

分析這段音訊。列出段落，並說明編曲在哪裡發生變化。

先開始分析，任務就緒後再讀取結構視圖。

聽律動怎麼形成

分析這首曲子。說明貝斯和鼓如何形成律動，並標出不確定的觀察。

使用報告裡的節奏與和聲觀察，再和你聽到的對照。

繼續追問

基於這次已經完成的分析，能量最明顯的抬升是怎麼來的？請引用報告，並說明它的限制。

有依據的追問使用 ask_about_song，並且要求分析已經成功完成、報告已解鎖。

技術細節和完整 MCP 示例

這些呼叫由主機處理。請保留傳回的任務識別碼，用來查詢狀態和指定視圖。

MCP: start_song_analysis + get_song_analysis

直接附加 MP3、WAV、FLAC、OGG 或 M4A 音訊。OAuth 將 Melogen 連線到 MCP 主機，產生結構化分析。

MP3, WAV, FLAC, OGG, M4A 12 個結構化視圖

參數

  • file — 主機提供的檔案描述元
  • report_locale — 報告偏好語言
  • view + cursor + limit — 選擇結構化視圖，並分頁查看結果
  • task_uuid — 分析任務回傳的識別碼
MCP / JSON
// MCP Tool Call (handled automatically by your AI agent)
{
  "tool": "start_song_analysis",
  "arguments": {
    "file": {
      "file_id": "host_uploaded_song_123",
      "download_url": "https://host.example/files/song.mp3",
      "file_name": "song.mp3",
      "mime_type": "audio/mpeg"
    },
    "client_request_id": "chatgpt-song-0001",
    "report_locale": "en"
  }
}

// Poll until analysis is complete
{
  "tool": "get_song_analysis",
  "arguments": {
    "task_uuid": "00000000-0000-0000-0000-000000000123",
    "view": "structure"
  }
}

// After completion, ask grounded follow-up questions
{
  "tool": "ask_about_song",
  "arguments": {
    "task_uuid": "00000000-0000-0000-0000-000000000123",
    "question": "Why does the chorus feel more energetic?",
    "client_request_id": "chatgpt-followup-0001"
  }
}

從停下的那一步繼續。

再次開始同一項分析之前，先查看已有任務。

主機連不上

回到 MCP 連線說明，檢查主機與 Melogen 的 OAuth 連線。請用你打算使用的同一個帳戶完成授權。

沒有音訊

確認檔案已在主機中附加，並且是支援的音訊格式。開始呼叫需要主機提供的檔案描述。

報告還在等待

保留開始呼叫傳回的 task_uuid，並用 get_song_analysis 查詢。等待中的回應不是完成的報告。

還不能追問

使用 ask_about_song 之前，確認分析已成功完成且報告已解鎖。請查看傳回的存取資訊和任務狀態，不要把缺少的回答當成結果。

常見問題

關於此 MCP 工作流程的常見問題。

分析提供 12 個結構化視圖，涵蓋概覽、結構、和聲、節奏、情緒、製作及其他音樂細節。

歌曲分析 — ChatGPT 與 MCP

直接附加 MP3、WAV、FLAC、OGG 或 M4A 音訊。OAuth 將 Melogen 連線到 MCP 主機，產生結構化分析。

使用 OAuth 連線
歌曲分析 — ChatGPT 與 MCP | Melogen AI | Melogenai