JinDaGe - musescore-mcp MCP Details

article

README

🚀 乐谱编辑助手MuseScore MCP服务器

乐谱编辑助手MuseScore MCP服务器将MuseScore与Claude Desktop等大语言模型客户端集成，让用户可以通过自然语言交互的方式进行基础音乐创作，为音乐创作带来了新的便捷体验。

简要演示链接：Canva设计页面

✨ 主要特性

通过MCP连接的大语言模型（LLM）可以实现以下操作：

连接到MuseScore并操作已打开的乐谱
添加音符和休止符
选择和删除音符
创建连奏（tuplets）
撤销更改
在不同的声部间切换

⚠️ 局限性

⚠️ 重要提示

该服务器无法理解同一声部内的多声部及在它们之间导航。

📦 安装指南

系统要求

Python 3.9或更高版本
安装MuseScore 3或4
MCP Python SDK

安装步骤

克隆此仓库：

git clone https://github.com/yourusername/musescore-mcp-server.git
cd musescore-mcp-server

安装依赖项，使用虚拟环境或全局安装：
```
pip install -r requirements.txt
```
将musescore-mcp-plugin插件复制到您的MuseScore插件目录中（在Mac上路径示例为：~/Documents/MuseScore4/plugins）

配置您的LLM使用MCP服务器（server.py）。如果您使用Claude Desktop和虚拟环境，可以通过创建claude_desktop_config文件如下：

{
 "mcpServers": {
   "musescore": {
     "command": "bash",
     "args": [
       "-c",
       "source /path/to/venv/activate && python3 /path/to/server.py"
     ]
   }
 }
}

💻 使用示例

准备MuseScore

打开MuseScore和您需要使用的乐谱。然后，连接到musescore-mcp-plugin插件并从插件菜单中启动它。

示例查询

一旦连接成功，您可以向Claude提出以下问题：

“帮我为旋律创作一些可能的和弦”
“根据这首作品的风格，在第1到12小节后扩展一个4小节的旋律”

📚 详细文档

开发

如果需要添加功能到MuseScore插件并进行测试，repo中提供的testClient.html文件可能是一个有用的开发工具——只需扩展它以调用您新增的功能。

musescore-mcp