项目简介

本项目是 Synthesizer V Studio 的 MCP 服务器实现，旨在连接大型语言模型 (LLM) 和 Synthesizer V Studio 歌声合成软件，使用户可以通过 LLM 以标准化的方式控制和编辑 Synthesizer V Studio 中的歌声项目。

主要功能点

• 资源管理:
  • 提供当前 Synthesizer V Studio 项目的信息。
  • 列出项目中的音轨，并获取音轨的详细信息，包括音符数据。
• 工具调用:
  • 获取项目信息。
  • 列出项目音轨。
  • 获取指定音轨的音符。
  • 在指定音轨中添加音符。
  • 编辑指定音轨中的音符。
  • 添加新的音轨。

安装步骤

1. 克隆仓库:

   git clone https://github.com/ocadaruma/mcp-svstudio.git
   

2. 配置 Synthesizer V Studio:

   • 复制 'sv-scripts' 目录下的 'StartMCPServerRequestHandler.lua' 和 'StopMCPServerRequestHandler.lua' 两个文件到 Synthesizer V Studio 的 scripts 文件夹。
     • (在 MacOS 上的 V2 Studio 中，默认路径为 '~/Library/Application Support/Dreamtonics/Synthesizer V Studio 2/scripts')
   • 在 Synthesizer V Studio 中运行 'StartServerRequestHandler' 脚本。
     • (通过 "Scripts" 菜单 > "MCP" > "StartServerRequestHandler" 启动)
     • ⚠️ 请务必先启动服务器脚本，再配置 MCP 客户端，否则可能出现连接问题。

3. 配置 MCP 客户端:

   • 将以下配置添加到 MCP 客户端的服务器配置中 (例如，在 MacOS 上的 Claude Desktop 客户端中，配置文件路径为 '~/Library/Application Support/Claude/claude_desktop_config.json')。

   {
     "servers": {
       "SynthesizerVStudioMCP": {
         "command": "/path/to/node",
         "args": [
           "/path/to/mcp-svstudio/dist/index.js"
         ]
       }
     }
   }
   

   • 配置说明:
     • '"SynthesizerVStudioMCP"': 服务器名称，可以自定义。
     • '"command"': Node.js 运行时的可执行文件路径，请替换为您的 Node.js 路径，例如 '/usr/local/bin/node' 或 'C:\Program Files\nodejs\node.exe'。
     • '"args"': 启动 MCP 服务器的参数，指向 'mcp-svstudio' 仓库 'dist' 目录下的 'index.js' 文件。请将 '/path/to/mcp-svstudio' 替换为您克隆仓库的本地绝对路径。

基本使用方法

完成安装和配置后，启动 MCP 客户端，客户端会根据配置连接到 Synthesizer V Studio MCP 服务器。之后，您可以使用 LLM 客户端提供的界面或指令，调用服务器提供的工具来控制 Synthesizer V Studio，例如：

• 让 LLM 读取当前项目信息，了解歌曲的节拍、速度等。
• 让 LLM 获取指定音轨的音符数据，进行分析或编辑。
• 指示 LLM 在指定音轨添加新的音符，创作歌词和旋律。
• 让 LLM 编辑现有音符的歌词、音高、时长等参数。
• 让 LLM 创建新的音轨，实现更复杂的编曲。

具体的功能使用取决于 LLM 客户端的实现和提供的交互方式。请参考 MCP 客户端的文档来了解如何使用此 MCP 服务器。