pd-mcp-server

让AI通过自然语言直接操控Pure Data音频编程环境

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pd-mcp-server。
它的用途是:让AI通过自然语言直接操控Pure Data音频编程环境
完整的 Skill 内容见:https://321skill.com/skills/pd-mcp-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“创建一个440Hz的正弦波振荡器,连接到一个截止频率为1000Hz的低通滤波器,然后打开音频输出。” 它会通过pd-mcp-server将这些指令转化为Pd能执行的命令,在你的Pure Data补丁中自动创建对应的对象并完成连线,让你立刻听到声音结果。你还可以继续要求它“把滤波器的截止频率调到2000Hz”,进行实时调整。

介绍

这是一个为Pure Data(Pd)设计的Model Context Protocol(MCP)服务器。它解决了在音频编程和交互式音乐创作中,需要手动连接复杂对象和参数、难以快速迭代的问题。通过将Pd的原生FUDI协议与MCP结合,它允许像Claude这样的AI助手直接理解并操作Pd补丁:创建对象、连接线路、开关音频、发送实时消息,就像在自然语言中描述音乐逻辑一样。

使用方式非常直接。用户需要在Pd中打开一个特定的主机补丁文件(mcp_host.pd),然后在支持的MCP客户端(如Claude Desktop)中安装此Skill。之后,用户就可以在聊天中直接告诉AI“创建一个正弦波振荡器并连接到低通滤波器”,AI便会通过该服务器将指令转化为Pd能理解的命令并执行。

它非常适合音乐技术爱好者、声音艺术家、交互装置开发者和教育工作者。这些人可能在快速原型设计、教学演示或探索声音可能性时,希望摆脱繁琐的图形化连线,用更直观的语言描述来驱动创作。

与早期基于OSC协议的同类尝试相比,它的核心区别在于架构的简洁性和可靠性。它绕过了额外的OSC层和中继守护进程,直接通过Pd内置的TCP套接字和动态补丁消息进行通信,因此无需安装任何外部库,对象ID也能与Pd环境保持严格同步,避免了复杂架构带来的脆弱性问题。

核心特点

直接使用Pure Data原生的FUDI协议和动态补丁消息进行通信,无需安装任何外部依赖库(如mrpeach/OSC),也无需额外的中继守护进程,架构更简洁,与Pd核心的同步更可靠。

注意事项

不适合需要脱离Pd环境、在纯代码层面进行离线音频渲染或批处理的场景。

常见问题

安装后还需要在Pure Data里做什么?

需要手动在Pure Data软件中打开项目自带的 `pd/mcp_host.pd` 文件,作为服务器与Pd通信的桥梁。

它能在Claude Desktop的普通聊天中使用吗?

可以,但需要通过下载.mcpb扩展文件并手动安装到Claude Desktop扩展中,或者手动编辑配置文件;通过插件市场安装的方式通常只适用于Claude Code和Cowork会话。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pd-mcp-server/raw/index.md 读取 pd-mcp-server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。