Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SoundMCP create a seamless cave ambience loop for my dungeon level"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Serveur MCP de composition musicale pour IA — créez de la jolie musique, des effets sonores et des ambiances pour vos jeux vidéo, sans aucune dépendance.
Le tout est généré mathématiquement en Node.js pur : théorie musicale (gammes, progressions d'accords, voice-leading, motifs) + DSP maison (réverbération type freeverb, délai ping-pong, écrêtage doux, normalisation). Aucune bibliothèque externe, aucun binaire, aucun appel réseau.
Sortie | Format | Usage |
Musique | WAV stéréo 44,1 kHz 16 bits (+ MIDI GM en option) | Fond sonore de jeu, ambiance, menu |
Effets sonores (SFX) | WAV stéréo 44,1 kHz 16 bits | Saut, pièce, dégât, explosion, arc, marteau de forge… |
Ambiances | WAV 44,1 kHz 16 bits, boucle parfaite | Pluie, orage, océan, grotte, feu de camp, vaisseau… |
Points clés :
Déterministe : même seed + mêmes paramètres = exactement le même son. Idéal pour itérer (« essaie le seed 42 ») et reproduire un rendu validé.
Boucles sans raccord : avec loop: true, la queue de réverbération/délai est repliée au début du morceau — le raccord est inaudible, parfait en fond de jeu continu. Les ambiances sont toujours bouclées parfaitement (crossfade circulaire intégré).
Options techniques : sampling_rate (22050 / 44100 / 48000) et mono (vrai WAV 1 canal, taille moitié) sur les trois outils de rendu.
Zéro dépendance : npm install inutile. Un seul fichier de serveur, node src/index.js.
19 styles musicaux, 32 effets sonores et 11 ambiances prêts à l'emploi.
Related MCP server: bfxr2-music-generator
Aucune dépendance. Node.js ≥ 18 suffit.
Via npm (recommandé) :
npm install -g @plagnito/soundmcpOu directement via npx -y @plagnito/soundmcp (télécharge et lance à la volée). Depuis les sources :
git clone https://github.com/Plagnito/soundmcp.git
node soundmcp/src/index.js # démarre le serveur MCP sur stdioDans la configuration OpenCode (opencode.json du projet ou global) :
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"soundmcp": {
"type": "local",
"command": ["npx", "-y", "@plagnito/soundmcp"]
}
}
}
}Ou en une commande : opencode mcp add soundmcp -- npx -y @plagnito/soundmcp
Avec les sources en local, utilise plutôt "command": ["node", "D:/chemin/soundmcp/src/index.js"] ; avec npm install -g @plagnito/soundmcp, "command": "soundmcp" fonctionne aussi.
claude mcp add soundmcp -- npx -y @plagnito/soundmcpOu dans .mcp.json du projet :
{
"mcpServers": {
"soundmcp": {
"command": "npx",
"args": ["-y", "@plagnito/soundmcp"]
}
}
}list_stylesListe les styles musicaux, les ambiances et les effets sonores avec leurs usages et tempos. À consulter d'abord : chaque style a un tempo naturel, une durée par défaut et des cas d'usage recommandés.
create_musicParamètre | Type | Défaut | Description |
| string | — | Un des 19 styles (voir ci-dessous) |
| nombre (5–600) | selon style | Durée cible, arrondie à des mesures entières |
| nombre (40–220) | selon style | BPM ; laisser le style choisir sinon |
| string | selon style | Tonalité EN ou FR : |
| entier ≥ 0 | aléatoire | Graine déterministe |
| booléen |
| Boucle sans raccord pour fond de jeu |
|
|
| WAV prêt à l'emploi, MIDI éditable dans un DAW, ou les deux |
| 22050 | 44100 | 48000 |
| Fréquence d'échantillonnage du WAV (22050 = taille moitié) |
| booléen |
| WAV 1 canal (taille encore moitié, utile en streaming web) |
| string |
| Dossier de sortie |
| string | — | Titre (sert aussi de nom de fichier) |
Retour : résumé musical complet (tonalité, tempo, progression, structure, seed) + chemins des fichiers.
create_sfxParamètre | Type | Défaut | Description |
| string | — | Un des 32 effets (voir ci-dessous) |
| entier ≥ 0 | aléatoire | Graine déterministe |
| nombre (0.05–1) |
| Volume relatif |
| 22050 | 44100 | 48000 |
| Fréquence d'échantillonnage du WAV |
| booléen |
| WAV 1 canal (taille moitié) |
| string |
| Dossier de sortie |
create_ambienceGénère une ambiance d'environnement en boucle parfaite : les derniers instants fondent dans les premiers (crossfade circulaire intégré au fichier), le fond sonore tourne en continu sans aucun raccord audible. La sortie est toujours un WAV bouclé — loop n'est pas un paramètre.
Paramètre | Type | Défaut | Description |
| string | — | Une des 11 ambiances (voir ci-dessous) |
| nombre (5–600) |
| Durée de la boucle ; plus longue = événements moins répétitifs |
| entier ≥ 0 | aléatoire | Graine déterministe |
| nombre (0.05–1) |
| Volume relatif |
| 22050 | 44100 | 48000 |
| Fréquence d'échantillonnage du WAV |
| booléen |
| WAV 1 canal (taille moitié) |
| string |
| Dossier de sortie |
Style | Ambiance | Idéal pour |
| Nappes aériennes, texture évolutive | Exploration, scènes calmes, fond d'atmosphère |
| Hip-hop apaisé, accords jazzy, swing doux | Villes cozy, menus détendus, streams |
| Ondes carrées 8-bit rétro | Jeux NES/GB, plateformer rétro |
| Cordes amples, cuivres, percussions | Boss, trailer, victoire, bandes-annonces |
| Tension mystérieuse, textures sombres | Enigmes, zones inquiétantes, infiltration |
| Médiéval-fantastique chaleureux | Villages, tavernes, quêtes |
| Pop énergique, joyeux | Gameplay dynamique, niveaux rythmés |
| Mélancolique, piano/intimos | Scènes d'émotion, pertes, fins tristes |
| Sombre, réverbérant, drone | Donjons, caves, zones hostiles |
| Thème de titre accrocheur | Écran titre, menus, hall principal |
| Pulse obsédant, ostinato nerveux | Poursuites, infiltration, compte à rebours |
| Fanfare lumineuse, percussions triomphantes | Boss vaincu, podium, ending |
| Bourg chaleureux, flûte et luth | Marchés, tavernes, zones sûres |
| Bataille nerveuse, riffs carrés | Boss rapides, arènes, duels |
| Guitares saturées en power chords, riff mémorable | Boss classiques, courses, entraînement |
| Quartet jazzy : accords 7e/9e, walking bass | Bar chic, casino, interrogation |
| Nappes sombres, cloches fantomatiques, bourdon grave | Peur, vide, chose qui vient |
| Boom-bap assuré : kick qui claque, basse ronde | Victoires urbaines, menus feutrés |
| Nappes lydiennes cristallines, carillons flottants | Cosmos, menus majestueux |
jump, coin, pickup, hit, damage, explosion, whoosh, laser, powerup, levelup, heal, click, hover, error, success, footstep, door, splash, heartbeat, alarm, sword, bubble, magic, teleport, bowShoot, gunShoot, thunder, questComplete, menuOpen, chestOpen, ghost, forge
Ambiance | Contenu |
| Pluie fine sur un feuillage : souffle grave doux, sizzle des gouttes, pluches éparses |
| Orage : pluie dense, vent qui se lève, coups de tonnerre espacés |
| Vent : souffle ample qui va et vient, sifflement léger sur les crêtes |
| Forêt de jour : brise dans les feuilles, oiseaux épars |
| Feu de camp : ronron chaud, crépitements vifs, petits éclats occasionnels |
| Océan : longues vagues qui montent et retombent, écume sur le sable |
| Rivière : clapotis continu de l'eau qui court, remous et petites vagues |
| Grotte : gravité sourde, gouttes d'eau qui résonnent avec leur écho |
| Vaisseau : hum grave des moteurs, souffle de ventilation, bips rares |
| Café : brouhaha de conversations, tintements de tasses, mouvement feutré |
| Nuit calme : très bas, grillons stridulants, chouette au loin, brise légère |
Le même moteur est exposé en CLI, pratique pour tester sans client MCP :
node src/cli.js list # styles + SFX + ambiances
node src/cli.js music lofi --dur 24 --seed 7 # musique lo-fi de 24 s
node src/cli.js music epic --seed 42 --midi # + export MIDI GM
node src/cli.js music fantasy --key "ré mineur" # tonalité en français
node src/cli.js music upbeat --dur 30 --no-loop # avec fondu de fin
node src/cli.js music ambient --sr 22050 --mono # léger (taille ÷4)
node src/cli.js sfx coin # effet sonore
node src/cli.js sfx explosion --seed 3 # variante déterministe
node src/cli.js ambience ocean --dur 60 --seed 11 # boucle parfaite de 60 s
node src/cli.js ambience cave --dur 12 --sr 22050 --monoOptions : --dur, --bpm, --key, --seed, --midi, --both, --loop/--no-loop, --sr, --mono, --out, --title, --json.
Itérer sur un rendu : gardez le style/la tonalité et changez uniquement le seed jusqu'à obtenir le morceau parfait ; le seed retenu reproduit exactement ce rendu.
Boucle de jeu : loop: true (défaut pour la plupart des styles) — la queue de réverbération est repliée au début, le raccord est inaudible. La durée du WAV correspond exactement au nombre de mesures.
Ambiance en continu : create_ambience sort toujours une boucle parfaite (crossfade intégré). Pour un fond d'environnement de longue durée, une boucle de 60–120 s suffit et les événements restent peu répétitifs.
Fichiers légers : sampling_rate: 22050 divise la taille par 2, mono: true encore par 2 (vrai WAV 1 canal) — combinés, un fond sonore de 60 s passe de ~10 Mo à ~2,6 Mo.
Fond sonore long : une boucle de 30–60 s en loop suffit pour des heures de jeu, sans fichier volumineux.
Piste pour DAW : format: "midi" donne un fichier GM à 5 pistes (nappe, arpège, mélodie, basse, batterie) réarrangeable dans n'importe quel DAW.
Cohérence de palette : même key + tempo proches à travers les styles = univers sonore homogène.
npm test # ~660 vérifications : en-têtes WAV (stéréo et mono), bouclage exact, couture des ambiances, déterminisme, RMS, MIDI, 32 SFX, 19 styles, 11 ambiances…src/
├── index.js Serveur MCP stdio (JSON-RPC 2.0, newline-délimité)
├── tools.js Catalogue d'outils partagé (MCP + CLI)
├── cli.js Interface ligne de commande
├── composer.js Composition : structure, accords, motifs, bus
├── theory.js Gammes, accords, degrés, parsing tonalité EN/FR
├── styles.js Les 19 styles (tempo, pools de tonalités, effets)
├── dsp.js Synthèse des instruments, réverbération, délai, master, WAV
├── midi.js Export MIDI GM (5 pistes, PPQ 480)
├── ambience.js Moteur d'ambiances (couches + événements + crossfade circulaire)
├── sfx.js Les 32 effets sonores
└── rng.js PRNG mulberry32 + hachage déterministe
scripts/smoke.js Suite de tests (~660 vérifications)
output/ Fichiers générésMIT
Crée une ambiance de jeu en boucle parfaite (WAV 16 bits) : rain (pluie), storm (orage), wind (vent), forest (forêt), campfire (feu de camp), ocean (océan), river (rivière), cave (grotte), spaceship (vaisseau), cafe (café), night (nuit). Couches de bruit continu + événements stochastiques (gouttes, oiseaux, tonnerre, vagues…) ; le crossfade circulaire rend le raccord de boucle inaudible. Déterministe via seed.
Inputs: kind (required), mono, seed, volume, +3 more.
Compose et rend une piste musicale de jeu (WAV stéréo, MIDI GM, ou les deux). 19 styles : ambient, lofi, chiptune, epic, mystery, fantasy, upbeat, sad, dungeon, menu, suspense, victory, village, combat, rock, jazz, horror, hiphop, space. Déterministe : même seed = même musique. loop: true produit une boucle sans raccord audible, parfaite en fond de jeu.
Inputs: style (required), key, loop, mono, +7 more.
Crée un effet sonore de jeu prêt à l'emploi (WAV 16 bits, 32 types) : action (jump, coin, pickup, hit, damage, powerup, levelup), combat (explosion, laser, sword, gunShoot, bowShoot), nature (thunder, splash, whoosh), UI (click, hover, error, success, menuOpen, chestOpen, questComplete), personnages (footstep, door, heartbeat, alarm, ghost, forge, bubble, magic, teleport). Déterministe via seed.
Inputs: kind (required), mono, seed, volume, +2 more.
Liste les styles musicaux disponibles (ambiant, lo-fi, chiptune, épique, combat, victoire…) et les effets sonores (SFX), avec leurs usages et tempos par défaut. À consulter avant de créer une musique.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 4 tools
Each tool maps to a clearly different output artifact: style/SFX discovery, a composed music track, a one-shot sound effect, and a looping ambience bed. The descriptions reinforce the boundaries (deterministic seeds, loop behavior, output formats) so an agent can pick the right generator without hesitation.
All four tools follow a strict snake_case verb_noun pattern (list_styles, create_music, create_sfx, create_ambience). The single list_ verb is used for the single read operation and create_ for all generators, which is perfectly predictable.
Four tools is a tight, well-scoped surface: three parallel generators plus one discovery helper that exists specifically to be consulted before generating. Nothing looks redundant or like filler.
The core lifecycle (discover options → generate music/SFX/ambience) is fully covered for a sound-asset server, where update/delete semantics are largely irrelevant. Minor gaps remain: list_styles does not appear to enumerate the ambience categories, and there is no tool to list or re-fetch previously generated files.
Game sound effects from a text prompt: game-ready WAVs with seamless loops and variations.
Generate, edit and stream royalty-free music, or search a licensed catalogue.
Generate sound effects and music from text for games, apps and videos. Returns audio file URLs.
Retro synth plus sampled instruments: sound effects, UI sounds and songs as WAV, Ogg or Opus.