Pure Data MCP Server

Pure Data MCP Server

2025.04.15 0

Python音频编程AI集成实时音频处理开发效率

Pd-MCP-Server是一个通过Model Context Protocol (MCP)实现Claude AI与Pure Data集成的项目。它允许用户通过自然语言动态创建、修改和控制Pure Data的音频处理模块（patches）。该系统由MCP Server、OSC Daemon和Pure Data Patch三个核心组件构成，支持动态对象创建、连接管理、DSP控制、参数实时调整等功能，适用于音频编程、实时音频处理和AI辅助创作等场景。

View on GitHub

Overview

基本能力

产品定位

Pd-MCP-Server是一个桥接AI与音频编程的工具，通过自然语言控制Pure Data实现动态音频处理。

核心功能

动态对象创建：通过Claude按需创建Pure Data对象
连接管理：构建复杂的信号流连接
DSP控制：远程启停音频处理
参数控制：实时修改对象参数
全局对象追踪：基于索引的可靠连接系统
错误处理：健壮的错误检测与报告
调试工具：完整的日志系统

适用场景

AI辅助音频编程
实时音频处理系统开发
教育场景下的音频编程教学
快速音频原型设计

工具列表

MCP Server：实现Claude的MCP接口
OSC Daemon：处理与Pure Data的OSC通信
Pure Data Patch：接收OSC消息的动态解决方案

常见问题

对象创建失败：检查Pure Data是否运行
连接问题：验证对象ID是否匹配
端口冲突：检查5000端口占用
消息格式错误：确保符合Pure Data补丁预期格式
对象丢失：尝试重启服务

使用教程

使用依赖

Python 3.7+
Pure Data (vanilla) 0.51+
安装Python包：

pip install python-osc fastmcp jsonschema

安装uv包管理器：

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

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

安装教程

克隆仓库：

git clone https://github.com/nikmaniatis/Pd-MCP-Server.git

配置Claude Desktop：

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

调试方式

检查服务日志
验证OSC端口通信
使用Pure Data的调试控制台

许可证

该项目遵循 MIT 开源许可条款。