返回 MCP 目录
public公开dns本地运行

musescore-mcp

MuseScore MCP服务器是一个连接MuseScore与LLM客户端的协议服务,支持通过自然语言进行基础音乐创作,如添加音符、删除、创建连音等操作。

article

README

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

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

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

✨ 主要特性

通过MCP连接的大语言模型(LLM)可以实现以下操作:

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

⚠️ 局限性

⚠️ 重要提示

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

📦 安装指南

系统要求

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

安装步骤

  1. 克隆此仓库:

    git clone https://github.com/yourusername/musescore-mcp-server.git
    cd musescore-mcp-server
    
  2. 安装依赖项,使用虚拟环境或全局安装:

    pip install -r requirements.txt
    
  3. 将musescore-mcp-plugin插件复制到您的MuseScore插件目录中(在Mac上路径示例为:~/Documents/MuseScore4/plugins)

  4. 配置您的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文件可能是一个有用的开发工具——只需扩展它以调用您新增的功能。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端