MCP Score 服务端

使用说明(Markdown格式)

  • 项目简介
    • 这是一个基于 MCP(Model Context Protocol)的音乐场景后端服务实现。它暴露资源、工具和提示模板等能力,方便大语言模型(LLM)通过标准化接口与音乐应用进行交互与控制。
  • 主要功能点
    • MCP 服务器核心:实现对资源、工具、提示的统一管理与暴露,支持通过 MCP 客户端进行请求和获取响应。
    • 应用桥接(Bridge):提供 MuseScore、Dorico、Sibelius 等音乐应用的 WebSocket/远程控制桥接,方便对当前乐谱进行读取、修改和控制。
    • 工具集:实现一系列能对乐谱进行读取、修改与分析的工具,便于 LLM 进行复杂任务编排,如读取乐段、转调、添加符号、设置节拍等。
    • 资源与技能集成:包含音乐生成技能、插件等组件的入口与安装流程,方便在集成环境中快速搭建并使用。
    • 服务器入口与部署:提供简单的服务器入口点,支持通过 mcp-score serve 启动服务器,并可用 Claude/其他模型对接实现端到端工作流。
  • 安装步骤
    • 安装主包
      • 使用 pip 安装 mcp-score(例:pip install mcp-score)。
    • 启动服务器
      • 直接运行命令 mcp-score serve(也可配置为集成在你的应用初始化流程中)。
    • 依赖与插件
      • 根据需要安装 Score 处理技能、MuseScore 插件等组件,以实现完整的工作流。
  • 服务器配置(示例配置,适用于 MCP 客户端连接) 该配置用于帮助 MCP 客户端连接并启动服务器。以下信息来自仓库的实际命令与入口点,确保与你的运行环境一致。 { "serverName": "mcp-score", "command": "mcp-score", "args": ["serve"] }
    • 说明:
      • serverName:服务器在你的客户端管理中使用的名称,建议与实际服务名称一致以便识别。
      • command:启动服务器的命令,本仓库提供的入口为 mcp-score。
      • args:启动参数,serve 表示以 MCP 服务器模式启动(默认入口)。
  • 基本使用方法
    • 启动后,服务器将提供资源、工具和提示模板等能力,LLM 客户端可通过 MCP 的标准请求请求对应的资源、执行工具、获取提示模板等。
    • 客户端连接后可以读取乐谱信息、修改乐谱、执行工具等操作,具体工具名称与参数请参考工具文档与 API。
    • 如需在 Claude、桌面客户端等环境中集成,请参照仓库中的集成文档(CLI、技能和插件安装步骤)进行配置。
  • 注意事项
    • 确保音乐应用(MuseScore/Dorico/Sibelius)的桥接组件可用并已正确配置。
    • 启动时若遇端口/地址冲突,请根据实际运行环境调整 host/port 配置。

服务器信息