MCP Score

mcp评分

AI驱动的乐谱。用简单的英语描述你想要什么——在MuseScore中获得一个可发表的分数。

快速演示

“创建一个大乐队图——32小节AABA形式，Bb键，66 BPM的慢蓝调，每个部分都有节奏变化和排练标记。”

Claude编写一个完整的music21脚本，执行它，然后递给你一个MusicXML文件，准备在MuseScore、Dorico、Sibelius或任何记谱应用程序中打开。

运行MuseScore插件后，您可以更进一步：

“阅读第9-16小节的旋律，并将其按照和弦进行排列为长号独奏。”

克劳德阅读现场乐谱，运用音乐智慧，并通过自然语言写回编曲。

安装

pip install mcp-score

或与 紫外线:

uv tool install mcp-score

然后设置所需的组件：

# Install the score generation skill (for Claude Code)
mcp-score install-skill

# Install the MuseScore plugin (for live score manipulation)
mcp-score install-plugin

# Or install both at once
mcp-score install

组件

mcp评分由三个部分组成：

MCP服务器

一个Python MCP服务器，包含18个工具，用于跨MuseScore、Dorico和Sibelius进行实时乐谱操作：连接/断开连接、阅读段落、添加和弦、设置小节线、转置等。运行通过 mcp-score serve （或者只是 mcp-score).

分数生成技能

克劳德密码 技能 它教Claude编写music21 Python脚本来生成乐谱。安装到 ~/.claude/skills/score-generate/。这处理了“从头开始创建分数”用例——不需要MCP往返。

MuseScore插件

一个QML插件，在MuseScore 4中运行WebSocket服务器，使MCP服务器能够实时读取和写入活动分数。支持19个命令，包括导航、音符输入、和弦符号、排练标记、吟游诗人、键/时间签名、节奏、转置和撤消。

配置

克劳德代码

将MCP服务器添加到项目或全局设置中：

claude mcp add mcp-score -- mcp-score serve

分数生成技能是单独安装的 mcp-score install-skill 并在您要求Claude创建分数时自动激活。

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-score": {
      "command": "mcp-score",
      "args": ["serve"]
    }
  }
}

MuseScore插件设置

之后 mcp-score install-plugin:

1. Open MuseScore 4
2. 首选 插件>插件管理器
3. 启用 MCP记分桥
4. 该插件在端口8765上启动WebSocket服务器

看 MuseScore插件文档 了解详情。

CLI参考

mcp-score serve            Run the MCP server (default)
mcp-score run      Run a Python script with music21 available
mcp-score install          Install skill and MuseScore plugin
mcp-score install-skill    Install the score-generate skill to ~/.claude/skills/
mcp-score install-plugin   Install the QML plugin to MuseScore's Plugins directory
mcp-score help             Show help

文档

贡献

看 贡献.md 用于开发设置、代码风格和PR流程。

作者

托马斯·斯科夫伦德·汉森-- skovlund.dev · thomas@skovlund.dev

许可证

麻省理工学院