polynodes-osc-mcp

日本語

MCP (Model Context Protocol) server for controlling PolyNodes by sonicLAB via OSC.

This server enables AI assistants like Claude to control PolyNodes' spatial sonic synthesis parameters through natural language.

Requirements

• Python 3.10+
• uv
• PolyNodes running and receiving OSC on 127.0.0.1:4799

Setup

Claude Code

Add to your project's MCP servers:

claude mcp add polynodes-osc-mcp -- uv run --directory /path/to/polynodes-osc-mcp python server.py

Or manually add to your Claude Code settings:

{
  "mcpServers": {
    "polynodes-osc-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/polynodes-osc-mcp", "python", "server.py"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "polynodes-osc-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/polynodes-osc-mcp", "python", "server.py"]
    }
  }
}

Available Tools (45 total)

| Category | Tools | |---|---| | Transport | Play/Stop, Preset Slot (1-10), BPM (10-300) | | Gain | Macro/Meso/Micro gain (-80 to 20 dB), Dry/Wet, Solo | | Envelope | Attack/Decay time per layer (0.01-0.5) | | Playback Rate | Rate per layer + stochastic modulation range | | Granulator | On/Off, chunk duration (10-1000), modulation range | | Bandpass Filter | On/Off, center frequency (80-8000 Hz), modulation per layer | | Comb Filter | On/Off, delay, modulation per layer | | Black Hole | On/Off, gravitational force per layer (0-1) | | White Hole | On/Off, reflection force per layer (0-1) | | Ring Modulator | On/Off, frequency per layer (1-3) | | Bitcrusher | On/Off, bit depth (0-1), sampling range (0-5) | | Resonator | On/Off, frequency distribution (1-3), balance (0-0.5) | | Cuboid FX | 3 cuboids On/Off, return level per layer (1-80) | | IsoMorph | On/Off, freq/amp/res modulation targets and depth | | Navigation | Random trigger, Rearrange, Poly Gates | | Tuning | PB rate and resonator tuning scale switches | | Camera | Zoom, Rotate | | Raw OSC | Send any OSC message directly |

Usage Examples

Once configured, you can control PolyNodes with natural language:

• "Play and set BPM to 120"
• "Turn on the Black Hole and set macro force to 0.8"
• "Enable the granulator with duration 500"
• "Randomize all parameters"
• "Set a dark ambient texture with slow playback rates and high reverb"

License

MIT