关键词

Decent Sampler鼓组预设音色采样乐器配置

使用说明

项目简介

Decent Sampler Drums MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，专门为 Decent Sampler 插件生成鼓组预设配置文件。它使用 TypeScript 开发，提供了用于分析 WAV 采样文件、配置鼓组参数和生成 Decent Sampler 插件 XML 预设文件的工具和提示。

主要功能点

  • WAV 文件分析和验证: 分析 WAV 采样文件的属性，例如采样率、位深度和声道数。
  • 全局音高和包络控制配置: 配置鼓组的全局音高（pitch）和 ADSR 包络 (envelope) 控制，以塑造声音特性。
  • 多麦克风通道路由配置: 支持多麦克风设置，允许将不同的麦克风信号路由到独立的输出通道，便于在 DAW 中进行混音。
  • 循环播放采样 (Round Robin) 配置: 实现 Round Robin 采样播放，提供多种模式（顺序、随机等）以增加声音的自然度和变化。
  • 灵活的速度分层处理: 支持根据 MIDI 速度 (velocity) 触发不同的采样层，实现动态响应。
  • 静音组支持: 配置静音组，允许某些鼓件在其他鼓件发声时自动静音，例如闭合踩镲打断开放踩镲。
  • 辅助输出路由: 将鼓组的不同部分路由到辅助输出，以便在 DAW 中进行更精细的音频处理和效果添加。

安装步骤

  1. 安装 Node.js 和 npm: 确保您的系统已安装 Node.js (v14 或更高版本) 和 npm (通常随 Node.js 一起安装)。
  2. 获取仓库代码: 克隆或下载 Decent Sampler Drums GitHub 仓库到本地。
  3. 安装依赖: 在仓库根目录下打开终端或命令提示符，运行命令 'npm install' 安装项目依赖。
  4. 构建服务器: 运行命令 'npm run build' 构建服务器代码。

服务器配置

为了将此 MCP 服务器添加到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加服务器配置信息。以下是 'claude_desktop_config.json' 文件的配置示例，该文件通常位于：

  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'
  • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
{
  "mcpServers": {
    "decent-sampler-drums": {  // server name:  服务器名称，在客户端配置中用于标识此服务器
      "command": "npx",        // command: 运行命令,  'npx' 允许您执行 Node.js 包，而无需全局安装
      "args": [               // args: 命令参数
        "-y",                 //   - 参数： 'npx -y'  自动确认安装包，无需用户交互
        "@dandeliongold/mcp-decent-sampler-drums" //   - 参数： 要执行的 npm 包名称，指向此 MCP 服务器
      ],
      "env": {}               // env: 环境变量，此处为空，表示不设置额外的环境变量
    }
  }
}

基本使用方法

  1. 启动 MCP 客户端: 启动您配置了 Decent Sampler Drums MCP 服务器的 MCP 客户端 (例如 Claude Desktop)。
  2. 选择服务器: 在 MCP 客户端中，选择 "decent-sampler-drums" 服务器以连接。
  3. 使用提示 (Prompts): 利用服务器提供的 "simple_preset_guidelines" (简单预设指南) 或 "advanced_preset_guidelines" (高级预设指南) 提示，根据您要创建的鼓组预设的复杂度选择合适的提示。
  4. 遵循提示指示: 在提示交互中，根据指示使用服务器提供的工具，例如：
    • 'analyze_wav_samples': 分析 WAV 采样文件，检查文件属性。
    • 'configure_drum_controls': 配置鼓组中各个鼓件的音高和包络控制。
    • 'configure_mic_routing': 配置多麦克风路由和混音设置。
    • 'generate_drum_groups': 根据配置生成 Decent Sampler 插件所需的 XML 预设文件内容。
  5. 指定采样目录: 当提示要求提供 'samplesDirectory' 参数时，请务必提供鼓采样文件所在的绝对路径，例如 '"C:/Users/username/Documents/DrumSamples"' (Windows) 或 '"/Users/username/Documents/DrumSamples"' (MacOS)。

开发和调试

  • 自动重建: 在开发过程中，可以使用 'npm run watch' 命令启动服务器，该命令会在代码更改时自动重新构建。
  • MCP Inspector: 使用 'npm run inspector' 命令可以启动 MCP Inspector，用于调试 MCP 服务器。

信息

分类

桌面与硬件

访问项目