MIDI MCP 服务器

概述

MIDI MCP 服务器是一个模型上下文协议 (MCP) 服务器，它使 AI 模型能够从基于文本的音乐数据生成 MIDI 文件。 此工具允许通过标准化接口以编程方式创建音乐作品。

安装

npm install
npm run build

与 MCP 客户端（例如 Cline）一起使用

构建项目后，只需将服务器添加到您的 MCP 客户端配置中：

"mcpServers": {
    "musicComposer": {
        "command": "node",
        "args": ["/path/to/midi-mcp-server/build/index.js"]
    }
}

将 /path/to/ 替换为您的项目目录的实际路径。

特性

• 从结构化的 JSON 音乐数据生成 MIDI 文件
• 支持多个音轨和乐器
• 可自定义的节拍、拍号和音符属性
• 将 MIDI 文件保存到指定位置

工具：create_midi

服务器提供一个名为 create_midi 的工具，用于从结构化的音乐数据生成 MIDI 文件。

输入参数

• title: 字符串 - 作品的标题
• composition: 字符串 - 表示音乐数据的 JSON 字符串
• output_path: 字符串 - MIDI 文件将保存的路径

作品格式

作品应遵循以下结构：

{
  "bpm": number,
  "timeSignature": { "numerator": number, "denominator": number },
  "tracks": [
    {
      "name": string,
      "instrument": number,
      "notes": [
        { "pitch": number, "startTime": number, "duration": number, "velocity": number }
      ]
    }
  ]
}

属性

• bpm: 每分钟节拍数
• timeSignature: 拍号（例如，{numerator: 4, denominator: 4} 表示 4/4 拍）
• tracks: 乐器音轨数组
  • name: 音轨名称
  • instrument: MIDI 程序编号 (0-127)
  • notes: 音符对象数组
    • pitch: MIDI 音符编号 (0-127)
    • startTime: 以节拍为单位的开始时间
    • duration: 以节拍为单位的音符持续时间
    • velocity: 音符力度/音量 (0-127)

示例

const composition = {
  "bpm": 120,
  "timeSignature": { "numerator": 4, "denominator": 4 },
  "tracks": [
    {
      "name": "Piano",
      "instrument": 0,
      "notes": [
        { "pitch": 60, "startTime": 0, "duration": 1, "velocity": 100 },
        { "pitch": 64, "startTime": 1, "duration": 1, "velocity": 100 },
        { "pitch": 67, "startTime": 2, "duration": 1, "velocity": 100 }
      ]
    }
  ]
};

依赖项

• @modelcontextprotocol/sdk: MCP 服务器实现
• midi-writer-js: 用于创建 MIDI 文件的库

演示

例如，下面的提示，这是一个创建 8 小节小调合唱曲的请求，可以由服务器处理：

8小節の合唱曲を作って。
若干マイナー調で、メロディックな音階を作ってほしい

https://github.com/user-attachments/assets/e20ebef0-fdbf-4e72-910d-41b94183f9d9

melodic_minor_chorus.mid

关于本地执行的说明

此 MCP 服务器在本地运行，并通过标准输入/输出 (stdio) 进行通信。 由于 MCP 客户端将自动启动服务器进程并建立通信，因此无需网络配置。