Pure Data

v1.0.0Developer Toolsstable

A Model Context Protocol (MCP) server for Pure Data, an open-source visual programming language and patchable environment for real-time computer music.

pd-mcp-servermcpai-integration
Share:
17
Stars
0
Downloads
0
Weekly
0/5

What is Pure Data?

Pure Data is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for pure data, an open-source visual programming language and patchable environment for real-time computer music.

A Model Context Protocol (MCP) server for Pure Data, an open-source visual programming language and patchable environment for real-time computer music.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server for Pure Data, an open

Use Cases

Work with Pure Data visual programming patches via MCP.
nikmaniatis

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedApr 30, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx pd-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Pure Data

Pd-MCP-Server connects AI assistants to Pure Data, the open-source visual programming environment for real-time computer music and audio processing. Using OSC (Open Sound Control) messaging over localhost, it lets Claude or any MCP client dynamically create Pure Data objects, connect them into signal chains, control DSP processing, and build audio patches entirely through natural language — making it a bridge between conversational AI and live computer music.

Prerequisites

  • Python 3.7 or higher installed
  • Pure Data (vanilla) version 0.51 or higher installed
  • uv package manager installed (https://astral.sh/uv)
  • Python packages: python-osc, fastmcp, jsonschema (installed via uv sync)
  • An MCP-compatible AI client such as Claude Desktop
1

Install uv package manager

uv is required to run the server. Install it with the one-line installer for your platform.

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
2

Clone the repository

Clone the Pd-MCP-Server repository to a local directory. Remember the full path — you will need it in the config file.

git clone https://github.com/nikmaniatis/Pd-MCP-Server.git
cd Pd-MCP-Server
uv sync
3

Open Pure Data and load the companion patch

Start Pure Data and open the OSC receiver patch included in the repository. This patch listens on port 5000 for commands from Claude and sends feedback on port 5001.

4

Configure Claude Desktop to launch the MCP server

Edit your Claude Desktop configuration file to add the Pd-MCP-Server, passing the OSC host and port environment variables. Replace PATH_TO_PD_MCP_SERVER with the absolute path to the cloned repo.

{
  "mcpServers": {
    "Pure Data MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Pd-MCP-Server",
        "run",
        "main.py"
      ],
      "env": {
        "PD_OSC_HOST": "127.0.0.1",
        "PD_OSC_PORT": "5000",
        "PD_FEEDBACK_PORT": "5001"
      }
    }
  }
}
5

Restart Claude Desktop and verify

Restart Claude Desktop so it picks up the new MCP server configuration. Once connected, you can ask Claude to create Pure Data objects and it will send OSC messages to the running Pure Data instance.

Pure Data Examples

Client configuration (Claude Desktop)

Full Claude Desktop configuration block for the Pure Data MCP server using uv as the runner.

{
  "mcpServers": {
    "Pure Data MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Pd-MCP-Server",
        "run",
        "main.py"
      ],
      "env": {
        "PD_OSC_HOST": "127.0.0.1",
        "PD_OSC_PORT": "5000",
        "PD_FEEDBACK_PORT": "5001"
      }
    }
  }
}

Prompts to try

Natural language prompts that map to real Pure Data patch operations via the MCP server.

- "Create an osc~ at 440 Hz, connect it to a dac~, and start DSP"
- "Build a simple synthesizer with a frequency slider and amplitude control"
- "Connect the osc~ outlet to a *~ 0.5 for half-volume output, then to the dac~"
- "Clear the workspace and start fresh"
- "Stop DSP processing"

Troubleshooting Pure Data

Commands from Claude have no effect in Pure Data

Ensure the Pure Data OSC receiver patch is open and DSP is enabled in Pure Data (Media → Audio On). The patch must be listening on PD_OSC_PORT (default 5000) before Claude sends commands.

Server fails to start with import errors

Run 'uv sync' inside the Pd-MCP-Server directory to install all required dependencies (python-osc, fastmcp, jsonschema). Make sure you are using Python 3.7 or higher.

Feedback from Pure Data is not reaching Claude

Pure Data sends feedback on port 5001 (PD_FEEDBACK_PORT). Verify that port 5001 is not blocked by a firewall and that PD_FEEDBACK_PORT in your config matches the port used in the Pure Data patch.

Frequently Asked Questions about Pure Data

What is Pure Data?

Pure Data is a Model Context Protocol (MCP) server that model context protocol (mcp) server for pure data, an open-source visual programming language and patchable environment for real-time computer music. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Pure Data?

Follow the installation instructions on the Pure Data GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Pure Data?

Pure Data works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Pure Data free to use?

Yes, Pure Data is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "pd-mcp-server": { "command": "npx", "args": ["-y", "pd-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Pure Data?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides