Decent Sampler Drums
About
Integrates with DecentSampler to generate drum kit configurations by analyzing WAV samples and creating XML-based presets with velocity layers and muting groups.
Details
- Author
- dandeliongold
- Repository
- dandeliongold/mcp-decent-sampler-drums
- GitHub stars
- 1
- Downloads
- 340
- License
- MIT License
- Categories
- Productivity, Other, Design, Developer Tools, AI, Infrastructure, Frontend
- Tags
- #mobile
Jump to
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Decent Sampler DrumsCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@dandeliongold/mcp-decent-sampler-drums
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Install dependencies:
npm install
2. Build the server:
npm run build
3. Add to your Claude Desktop config:
Windows: %APPDATA%/Claude/claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"decent-sampler-drums": {
"command": "npx",
"args": [
"-y",
"@dandeliongold/mcp-decent-sampler-drums"
],
"env": {}
}
}
}
When using this MCP server to generate simple presets, you should always reference the simple_preset_guidelines prompt.
For more complex presets (including sections such as buses, effects, etc.), reference the advanced_preset_guidelines prompt. Note that creating complex presets with a large number of samples can still be unstable and may exceed Claude Desktop's maximum message length.
Both prompts will ask you to provide a samplesDirectory argument - this should be the absolute path to your drum samples folder (e.g., "C:/Users/username/Documents/DrumSamples"). The prompt will then automatically use this directory in all examples and configurations, making it easier to follow along with the correct paths for your system.
configure_drum_controls
Configure global pitch and envelope controls for each drum type. This tool will: - Add per-drum pitch controls with customizable ranges - Configure ADSR envelope settings for natural decay control - Generate proper XML structure for global drum controls Error Handling: - Validates pitch range values (min/max must be valid numbers) - Ensures envelope times are positive values - Verifies curve values are within -100 to 100 range - Returns detailed error messages for invalid configurations Success Response: Returns XML structure containing: - Global controls for each drum type - MIDI CC mappings for real-time control - Properly formatted parameter bindings
configure_round_robin
Configure round robin sample playback for a set of samples. This tool will: - Validate sequence positions - Verify sample files exist - Generate proper XML structure for round robin playback Error Handling: - Checks if sample files exist at specified paths - Validates sequence positions are unique and sequential - Ensures mode is one of: round_robin, random, true_random, always - Returns specific error messages for missing files or invalid sequences Success Response: Returns XML structure with: - Configured playback mode - Sample sequence assignments - Proper group organization for round robin playback
analyze_wav_samples
Analyze WAV files to detect common issues in drum kit samples. This tool checks for: - Non-standard WAV headers that may cause playback issues - Metadata inconsistencies that could affect multi-mic setups - Sample rate and bit depth compatibility - Channel configuration issues - File size and format validation Error Handling: - Reports detailed header format issues - Identifies metadata inconsistencies between related samples - Flags potential playback compatibility problems - Returns specific error messages for each issue type Success Response: Returns detailed analysis including: - WAV header information - Sample metadata - Potential compatibility issues - Recommendations for fixes IMPORTANT: Always use absolute paths (e.g., 'C:/Users/username/Documents/Samples/kick.wav') rather than relative paths.
configure_mic_routing
Configure multi-mic routing with MIDI controls for drum samples. This tool will: - Set up individual volume controls for each mic position (close, OH L/R, room L/R) - Route each mic to its own auxiliary output for DAW mixing - Configure MIDI CC mappings for mic volumes - Generate proper XML structure for DecentSampler Error Handling: - Validates mic position assignments - Checks for duplicate MIDI CC assignments - Ensures valid output routing targets - Verifies bus indices are unique and valid - Returns specific errors for routing conflicts Success Response: Returns XML structure containing: - Configured mic bus routing - Volume control mappings - MIDI CC assignments - Complete routing matrix for all samples
generate_drum_groups
Generate DecentSampler <groups> XML for drum kits. This tool supports two configuration types: BasicDrumKitConfig: - For simple presets with minimal features - No UI controls, effects, or routing - Only supports basic sample mapping and optional velocity layers - Recommended for straightforward drum kits AdvancedDrumKitConfig: - For complex setups combining multiple features - Supports UI controls, effects, and routing - Integrates with other tools (configure_drum_controls, configure_mic_routing, etc.) - Use when you need advanced features like round robin or multi-mic setups Best Practices: - IMPORTANT: Always use absolute paths (e.g., 'C:/Users/username/Documents/Samples/kick.wav') - Group all samples for a drum piece into a single group - When using multiple mic positions, include them all in the same group - Use velocity layers within a group to control dynamics Error Handling: - Validates all sample paths exist - Checks for valid MIDI note numbers - Ensures velocity layers don't overlap - Verifies muting group configurations - Returns specific errors for any invalid settings Example Configurations: 1. Basic Configuration (simple drum kit): { "globalSettings": { "velocityLayers": [ { "low": 1, "high": 42, "name": "soft" }, { "low": 43, "high": 85, "name": "medium" }, { "low": 86, "high": 127, "name": "hard" } ] }, "drumPieces": [{ "name": "Kick", "rootNote": 36, "samples": [ {"path": "C:/Samples/Kick_Soft.wav"}, {"path": "C:/Samples/Kick_Medium.wav"}, {"path": "C:/Samples/Kick_Hard.wav"} ] }] } 2. Advanced Configuration (multi-mic kit with controls): { "globalSettings": { "velocityLayers": [ { "low": 1, "high": 127, "name": "full" } ], "drumControls": { "kick": { "pitch": { "default": 0, "min": -12, "max": 12 }, "envelope": { "attack": 0.001, "decay": 0.5, "sustain": 0, "release": 0.1 } } }, "micBuses": [ { "name": "Close Mic", "outputTarget": "MAIN_OUTPUT", "volume": { "default": 0, "midiCC": 20 } } ] }, "drumPieces": [{ "name": "Kick", "rootNote": 36, "samples": [ { "path": "C:/Samples/Kick_Close.wav", "micConfig": { "position": "close", "busIndex": 0 } } ], "muting": { "tags": ["kick"], "silencedByTags": [] } }] } Success Response: Returns complete XML structure with: - Organized sample groups - Velocity layer mappings - Muting group configurations - All sample references and settings - Advanced features when using AdvancedDrumKitConfig
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"decent sampler drums": {
"env": {},
"args": [
"-y",
"@dandeliongold/mcp-decent-sampler-drums"
],
"command": "npx"
}
}
}Linux
{
"env": [],
"args": [
"-y",
"@dandeliongold/mcp-decent-sampler-drums"
],
"command": "npx"
}Macos
{
"env": [],
"args": [
"-y",
"@dandeliongold/mcp-decent-sampler-drums"
],
"command": "npx"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"-y",
"@dandeliongold/mcp-decent-sampler-drums"
],
"command": "cmd"
}Generates Decent Sampler drum kit configurations.
A Model Context Protocol server for generatingDecent Samplerdrum kit configurations.
This TypeScript-based MCP server provides specialized tools and prompts for creating DecentSampler drum kit presets, including WAV file analysis and XML generation.
Warning:Creating complex presets may end up exceeding Claude Desktop's maximum message length. We are still working on streamlining this tool to work around this limitation. If you are creating simple presets without a lot of mics or other variations, the xml file should be small enough for Claude to write to a file.
- WAV file analysis and validation
- Global pitch and envelope controls
- Multi-mic routing with MIDI controls
- Round robin sample playback
- Flexible velocity layer handling
- Muting group support
- Auxiliary output routing
- How do I use these tools?- Step-by-step workflows with real examples
- Tools Documentation- Detailed information about each available tool
- Input Schemas- TypeScript interfaces and parameter descriptions
- Node.js (v14 or higher)
- npm (usually comes with Node.js)
- Claude Desktop app (for use with Claude)
Windows:%APPDATA%/Claude/claude_desktop_config.jsonMacOS:~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "decent-sampler-drums": { "command": "npx", "args": [ "-y", "@dandeliongold/mcp-decent-sampler-drums" ], "env": {} } } }
When using this MCP server to generate simple presets, you should always reference thesimple_preset_guidelinesprompt.
For more complex presets (including sections such as buses, effects, etc.), reference theadvanced_preset_guidelinesprompt. Note that creating complex presets with a large number of samples can still be unstable and may exceed Claude Desktop's maximum message length.
Both prompts will ask you to provide a samplesDirectory argument - this should be the absolute path to your drum samples folder (e.g., "C:/Users/username/Documents/DrumSamples"). The prompt will then automatically use this directory in all examples and configurations, making it easier to follow along with the correct paths for your system.
Decent Sampler is a FREE sampling plugin that allows you to play samples in the Decent Sampler format.
- Download Decent Sampler Plugin
- Decent Sampler Developer Resources
The goal of this MCP server is to make it easier to set up your own presets, whether you're playing your kitchen utensils into your phone, or recording a full kit in a studio. To create your own drum kits, you'll also need samples.
If you don't already have samples ready to go, here are some resources to get started:
- Drum Samples Collection- Various drum kits and percussion samples
- Dub & Reggae Sounds- Specialized collection of reggae drum sounds
Sample Pack Nation:Oberheim DMX/DX Drumkits- Classic drum machine sounds (Under 10 USD/EUR)
The World's First AI Music MCP Beyond images and video, your agent can now generate music.
AI copilot for Ableton Live 12 — 91 MCP tools for real-time music production, sound design, and mixing
AI-powered music production in REAPER via the Model Context Protocol — 150 tools for composition, mixing, mastering, and audio analysis.
generate lyrics, song and background music(instrumental)
Control Ableton Live with AI prompts for music production, track creation, and session manipulation.
AI-powered audio generation using the MiniMax Music API.
MCP server for AI music catalog — search, stream, and browse 1M+ AI-generated tracks
Personalized music recommendations and playlist management for TIDAL, powered by its API and LLM filtering.
Generate high-quality text-to-speech and text-to-voice outputs using the DAISYS platform.
An AI co-pilot for Foundry VTT: run combat, set the scene, and voice NPCs by talking to your assistant. 193 tools across 24 domains, works with content you already own.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
