Room impulse responses from a plain description, via pyroomacoustics.
An MCP server that lets any compatible agent generate an IR from natural language and write it where you want. Describe a space in any language and the calling model turns it into room dimensions, an absorption coefficient and mic/source positions.
Useful for matching a room you no longer have access to (dry foley or dialogue recorded on location, with no IR captured at the time), and for building reverbs that are realistic, impossible, or somewhere between.
"a stairwell, mic near the wall, quite reverberant, put it in my samples folder"
2.4 × 4.8 × 11.2 m · absorption 0.06 (wet) · mic near wall · source near wall
2.33 s stereo, 48000 Hz
/Users/you/Music/samples/medium_near_wall_wet_b7b2.wav
The result loads into any convolution reverb.
Anything left unspecified is randomised. Values you do supply are used as given, but exact mic placement and per-wall absorption are redrawn on every call, so the same numbers twice produce a different take. Call again to reroll.
Requires uv. Add the
following to your MCP client configuration
(~/Library/Application Support/Claude/claude_desktop_config.json on macOS)
and restart the client:
{
"mcpServers": {
"rir": {
"command": "uvx",
"args": ["--from", "git+https://github.com/tbimbato/MCP_RiR", "mcp-rir"],
"env": {
"RIR_OUTPUT_DIR": "~/Music/IRs"
}
}
}
}The first launch takes a minute while pyroomacoustics is fetched.
RIR_OUTPUT_DIR sets the default destination. Without it, files land in
~/RIR-MCP/. A destination can also be given per request ("put it in my
samples folder", "call it hallway.wav").
generate_room_ir. Every argument is optional.
| argument | description |
|---|---|
width_m, length_m, height_m |
room size in metres, 0.5 to 40 |
absorption |
surface reflectivity, 0.02 to 0.95. Bare tile or concrete around 0.05, plaster 0.15, carpeted 0.3, heavily treated 0.5 |
mic_position, source_position |
center, corner or near wall |
output_path |
a folder, or a full path ending in .wav |
Output is a stereo 48 kHz 24-bit WAV, peak-normalised, capped at 20 seconds. Out-of-range values are clamped rather than rejected, and the reply says so.
Ranges, defaults and the parameters that shape the sound are in
src/mcp_rir/config.py.
- Stereo output, 48 kHz 24-bit, peak-normalised.
- Per-request output path, so files land where you ask.
- Microphone directivity. The pair is currently two omnidirectional capsules, the weakest option for stereo image. Cardioid, hypercardioid and figure-of-eight patterns would allow real techniques (XY, ORTF, Blumlein) and widen the image considerably.
- Multichannel output. Quad and octophonic. Adding microphones to the same simulation is inexpensive; the work is picking layouts that convolvers actually accept.
- Ambisonic B-format (first order, W/X/Y/Z). Higher priority than a fixed quad, since it decodes to any speaker arrangement afterwards.
- Room rendering. An image of the simulated geometry with mic and source positions, written next to the WAV, to see what was generated without loading the file.
- Non-shoebox geometry. Arbitrary polygonal footprints extruded to 3D: L-shaped rooms, narrow corridors, concave spaces that focus reflections. No new dependencies needed.
- Post-processing tool. Reshaping an existing impulse response: reversed decay, gated tails, extreme time stretch. Taking a file path means it would work on impulse responses not generated here.
- Tuning. The default ranges are informed guesses, not yet adjusted by ear.
Suggestions and contributions welcome.
git clone https://github.com/tbimbato/MCP_RiR
cd MCP_RiR
pip install -e .
Point the configuration at that checkout:
{
"mcpServers": {
"rir": {
"command": "/path/to/your/python",
"args": ["-m", "mcp_rir.server"]
}
}
}MIT