AI导哈

PolyNodes OSC 控制服务器

一个通过 OSC 控制 PolyNodes 空间声音合成器的 MCP 服务器，让 AI 助手能够使用自然语言调整播放、BPM、滤波器、颗粒合成等参数。

  • by naotochan
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 naotochan/polynodes-osc-mcp

使用说明

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 (default 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"]
    }
  }
}

OSC connection

Override the default host and port with environment variables:

Variable Default Description
POLYNODES_OSC_HOST 127.0.0.1 PolyNodes OSC host
POLYNODES_OSC_PORT 4799 PolyNodes OSC port

API (v0.2)

Two tools and one resource replace the previous per-parameter tool list:

Name Type Description
polynodes_set tool Batch-set one or more params in a single OSC burst
polynodes_raw tool Send any OSC address/value (escape hatch)
polynodes://catalog resource JSON catalog of param names, OSC addresses, ranges, and per-layer requirements

Read polynodes://catalog when unsure of param names or valid ranges. Per-layer params (gain, playback_rate, filter_freq, etc.) require level: macro, meso, or micro. Switches accept 0/1 or bool.

Param categories include transport, gain, envelope, playback rate, granulator, filters, DSP interactables (Black Hole, White Hole, Ring Mod, Crusher, Resonator), Cuboid FX, IsoMorph, navigation, tuning, and camera.

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"
  • "Set macro playback rate to 0.5 and meso to 2.0 in one batch"

Example polynodes_set batch:

[
  {"param": "play", "value": 1},
  {"param": "bpm", "value": 120},
  {"param": "blackhole", "value": true},
  {"param": "blackhole_force", "level": "macro", "value": 0.8}
]

Development

uv sync --extra dev
pytest

License

MIT

相关 MCP