Midi MCP Server

](https://mseep.ai/app/tubone24-midi-mcp-server)


MIDI MCP服务器

A. 模型上下文协议（MCP） 用于AI驱动的MIDI作曲的服务器。从结构化JSON数据生成MIDI文件，支持和弦名称、交互式钢琴滚动预览UI和多种部署模式。

demo

寻找代理技能方法？ 它用更少的上下文创作出更好的歌曲： 大号24/midi代理技能

______________________________________________________________________

特性

• 两个MCP工具: create_midi （带交互式预览UI）和 parse_chord
• 丰富的音调输入：MIDI数字、音符名称字符串("C4")、音高数组或和弦名称("Cmaj7")
• 和弦库：25+和弦品质——大调、小调、小调、8月、7日、maj7、m7、sus2、sus4、power等
• 灵活的持续时间：数字节拍，标准字符串('4', '8')，点缀('d4')，三胞胎('T8')
• 音乐理论资源：7个内置参考文件可作为MCP资源访问
• 三种运输方式：stdio、HTTP或Cloudflare Workers（远程）
• MCP应用程序用户界面：对话中直接呈现的钢琴滚动可视化和音频播放

______________________________________________________________________

部署选项

选项A——远程（Cloudflare Workers）

预部署的远程服务器可用：

https://midi-mcp-server.tubone24.workers.dev/mcp

将其添加到任何支持流式HTTP的MCP客户端（例如Claude.ai）：

{
  "mcpServers": {
    "midi": {
      "type": "http",
      "url": "https://midi-mcp-server.tubone24.workers.dev/mcp"
    }
  }
}

选项B——本地stdio（建议用于桌面客户端）

构建并配置为本地stdio服务器：

npm install
npm run build

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

选项C——本地HTTP

作为本地Streamable HTTP服务器运行：

node build/index.js --http
# or with a custom port:
node build/index.js --http --port=8080

服务器公开：

• POST /mcp --MCP可流式HTTP端点
• GET /health --健康检查({"status":"ok","version":"0.2.0"})

______________________________________________________________________

工具

create_midi

从结构化作曲数据生成MIDI文件。返回base64编码的MIDI，并在支持的MCP客户端（MCP App）中呈现交互式钢琴滚动预览和音频播放。

mid

输入

输出 （结构化内容）

______________________________________________________________________

parse_chord

解析和弦名称并返回其分量MIDI音高和音符名称。有助于在写作前理解语音。

输入

输出示例

{
  "chord": "Cmaj7",
  "octave": 4,
  "midiNumbers": [60, 64, 67, 71],
  "noteNames": ["C4", "E4", "G4", "B4"]
}

______________________________________________________________________

组合模式

{
  "bpm": 120,                              // tempo (also accepted: "tempo")
  "timeSignature": { "numerator": 4, "denominator": 4 },  // optional, default 4/4
  "tracks": [
    {
      "name": "Piano",                     // optional
      "instrument": 0,                     // GM program number 0–127 (optional)
      "notes": [
        {
          "pitch": 60,                     // MIDI number, note name "C4", or array [60, 64, 67]
          "chord": "Cmaj7",                // OR use chord name (overrides pitch)
          "beat": 1,                       // beat position (1-based); OR use startTime
          "startTime": 0,                  // tick offset (alias: "time")
          "duration": "4",                 // see Duration Reference below
          "velocity": 100,                 // 0–127 (optional, default 100)
          "channel": 0                     // MIDI channel 0–15 (optional)
        }
      ]
    }
  ]
}

音高输入格式

支持的事故： # （尖锐）， b （平坦）。示例： "F#5", "Bb3".

持续时间参考

支持的和弦质量

______________________________________________________________________

MCP资源

服务器公开7个音乐理论参考文献作为MCP资源：

支持资源读取的MCP客户端可以将这些作为上下文传递给AI，从而实现理论感知的组合。

______________________________________________________________________

示例组成

const composition = {
  bpm: 120,
  timeSignature: { numerator: 4, denominator: 4 },
  tracks: [
    {
      name: "Piano",
      instrument: 0,
      notes: [
        { chord: "Cmaj7", beat: 1, duration: "2", velocity: 90 },
        { chord: "Am7",   beat: 3, duration: "2", velocity: 90 },
        { chord: "Fmaj7", beat: 5, duration: "2", velocity: 90 },
        { chord: "G7",    beat: 7, duration: "2", velocity: 90 }
      ]
    },
    {
      name: "Melody",
      instrument: 0,
      notes: [
        { pitch: "E4", beat: 1, duration: "4", velocity: 100 },
        { pitch: "G4", beat: 2, duration: "4", velocity: 100 },
        { pitch: "A4", beat: 3, duration: "2", velocity: 110 }
      ]
    }
  ]
};

______________________________________________________________________

演示

下面的提示生成了一首8小节旋律小调合唱曲：

Create an 8-bar choral piece in a slightly minor, melodic scale.

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

旋律_小调_合唱.mid

______________________________________________________________________

构建与开发

npm install

# Full build (UI + server)
npm run build

# Build steps individually
npm run build:ui     # Vite — builds the MCP App preview HTML
npm run build:server # tsc — compiles TypeScript server

# Deploy to Cloudflare Workers
npm run deploy

# Run tests
npm test
npm run test:coverage

______________________________________________________________________

依赖项