Melogen / MCP

在 ChatGPT 中将乐谱转换为 MIDI

通过 OAuth 连接 Melogen，在 ChatGPT 或兼容的 MCP 客户端中附加乐谱，请 AI 返回 MIDI 或 MXL 文件。

查看 MCP 连接指南

适用于支持 OAuth 和文件附件的 MCP 客户端。

直接使用在线乐谱转 MIDI 工具

PDF, PNG, JPGMIDI, MXL

先选一种适合你的乐谱处理方式

如果乐谱已经出现在 AI 对话里，MCP 连接可以让你在原来的对话中说明需要什么文件，由兼容客户端传递附件并获取任务结果。如果只是想上传一份文件完成转换，直接使用网页工具会更方便。

PDF, PNG, JPGMIDI, MXL

继续在 AI 对话中处理

适合希望把乐谱附件、输出要求和任务进展放在同一段对话中的用户。客户端需要能够调用转换工具、完成 OAuth 授权，并传递文件附件。

查看 MCP 连接指南
PDF, PNG, JPGMIDI, MXL

直接在网站上转换

适合希望自己上传乐谱、通过网页界面操作的用户。这条路径不需要配置 MCP 客户端。

直接使用在线乐谱转 MIDI 工具

连接前，先确认这三件事

第一次发送乐谱前，检查客户端、账户和文件。能聊天，并不代表客户端具备执行这套流程的全部能力。

  • 客户端支持所需的连接能力

    ChatGPT 的连接选项取决于账户、工作区设置和可用的应用能力。其他 MCP 客户端也需要支持远程 MCP、OAuth 和文件附件。开始前，请先查看客户端提供的连接选项。

  • 准备好你的 Melogen 账户

    按照连接指南，通过 OAuth 授权账户。转换会使用 Melogen 账户及其可用积分；从对话中发起请求，也需要满足服务本身的账户要求。

  • 把原始乐谱作为附件发送

    附加包含乐谱的 PDF、PNG 或 JPG。尽量让页面清晰、方向正确，保留完整的谱表和页边。这些是输入准备建议，不代表每个音符都能被正确识别。

请在客户端内附加文件，不要用公开链接或 YouTube 链接替代附件。如果客户端不支持附件，可以使用网页转换工具。

从 ChatGPT 附件到 MIDI 文件

完成连接后，在对话中提交乐谱并获取结果。

  1. 将 Melogen 连接到客户端

    按照 MCP 连接指南，在兼容客户端中通过 OAuth 授权你的 Melogen 账户。

  2. 附加乐谱并提出要求

    附加 PDF、PNG 或 JPG 乐谱，说明需要 MIDI 或 MXL。AI 会使用客户端提供的文件描述符调用 start_sheet_music_conversion。

  3. 获取任务结果

    AI 使用 get_sheet_music_conversion 查询任务。任务成功后，通过返回的链接下载输出文件。

像平常一样，说明你想怎么用这份谱子

不用自己写工具调用。附上乐谱，说清楚需要哪种文件，再由兼容客户端处理请求。下面是可以参考的表达方式，不是实际转换结果。

想在编曲软件里试听

帮我把这份乐谱转成 MIDI。我想放进音乐软件里试听，再调整音符。文件准备好后，把下载链接给我。

下一步要试听、编辑音符或继续编曲，可以选择 MIDI。

想继续修改乐谱

请把附件里的乐谱转成 MXL，我要放到记谱软件中继续修改。查一下任务进度，完成后把文件给我。

下一步主要是编辑乐谱，可以选择 MXL。

两种文件都留一份

这份谱子请同时输出 MIDI 和 MXL。继续查询同一个任务，成功后把两个文件的下载链接发给我。

既要在编曲软件里处理音符，又要在记谱软件里编辑谱面时，可以同时请求两种格式。

开发者参考：参数与完整 MCP 调用示例

客户端负责提供文件描述符。提交一次任务后，保留任务标识，再查询该任务的状态和产物。下方是请求与响应示例，不是正在执行的任务。

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 / JSON
// 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://..."}
  ]
}

选 MIDI 还是 MXL，取决于你接下来要做什么

两种文件都能表达音乐，但适合的后续工作不同。通过这项连接，可以请求其中一种，也可以同时获取两种。

MIDI：试听与音符编辑

MIDI 保存音符事件等演奏信息。导入兼容的音乐软件后，可以选择音色、试听序列，或者修改音符和时间位置。它不是录音文件，也不会保留原始纸面乐谱的视觉排版。

MXL：在记谱软件之间传递乐谱

MXL 是压缩的 MusicXML，用于交换数字乐谱。可以在兼容的记谱软件中打开，继续编辑。不同软件的导入结果和排版可能有所不同，打开后仍需检查。

下载完成后，和原谱对照一遍

正式编曲、排练或分发前，检查音符、节奏、声部和小节。保留原始附件作为对照：任务完成代表已经生成文件，并不代表所有音乐细节都经过核实。

格式参考

了解 MIDI 消息了解压缩 MusicXML（.mxl）

连接或转换卡住时，从哪一步查起

先判断问题发生在哪个阶段。找不到连接、读不到附件和任务仍在处理，分别需要不同的处理方式。

客户端里找不到连接入口

确认客户端和账户允许使用所需的 MCP 能力，再按照 Melogen 连接指南操作。如果使用受管理的工作区，连接权限还可能取决于管理员设置。

工具无法读取附件

确认发送的是 PDF、PNG 或 JPG 附件，而不只是一条链接。可以在兼容客户端中重新附加原始文件。如果客户端无法传递附件，请使用在线转换器。

任务一直显示处理中

请客户端查询已有任务，而不是再次发起转换。反馈问题时保留任务标识。如果任务失败，先根据返回的信息检查账户或输入状态，再决定是否重新提交。

结果链接打不开了

请在链接有效时保存文件。如果链接过期或访问被拒绝，先查看任务返回的信息，必要时联系支持。不要仅为排查下载链接就重新发起一次转换。

ChatGPT 与 MCP 接入常见问题

了解 AI 客户端中的授权、附件传递与结果获取。

客户端需要支持 MCP 连接、OAuth 登录和文件附件。按照 Melogen MCP 连接指南授权账户；可用的连接选项取决于客户端和账户。

在 ChatGPT 中将乐谱转换为 MIDI

通过 OAuth 连接 Melogen，在 ChatGPT 或兼容的 MCP 客户端中附加乐谱，请 AI 返回 MIDI 或 MXL 文件。

查看 MCP 连接指南
在 ChatGPT 中将乐谱转换为 MIDI | Melogen AI | Melogenai