纯数据MCP服务器
该项目通过模型上下文协议（MCP）提供Claude AI和纯数据之间的集成。通过这种集成，Claude可以通过自然语言动态创建、修改和控制纯数据补丁。
已知问题
示例补丁(example patch.pd)工作不正常。
概述
该系统由三个核心组件组成：
- MCP服务器 (
mcp_server.py)：为Claude实现模型上下文协议接口 - OSC守护进程 (
osc_daemon.py)：处理OSC与纯数据的通信 - 纯数据补丁 (
absolute_final_solution.pd)：接收OSC消息的动态修补解决方案
特性
- 动态对象创建：通过Claude按需创建任何纯数据对象
- 连接管理：将对象连接在一起以构建复杂的信号流
- DSP控制：远程启动和停止音频处理
- 参数控制：实时修改对象的参数
- 全局对象跟踪：可靠的基于索引的连接系统
- 错误处理：强大的错误检测和报告
- 调试工具：综合测井系统
最近的更新
安装
先决条件
- Python 3.7+
- 纯数据（香草）0.51+
- 所需的Python包：
- python-osc - fastmcp - jsonschema
安装 uv
在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"了解更多： 星光散射/紫外线
______________________________________________________________________
🛠️ 用法
克隆存储库
git clone https://github.com/nikmaniatis/Pd-MCP-Server.git与Claude Desktop集成
- 打开：
Claude > Settings > Developer > Edit Config > claude_desktop_config.json
- 添加以下块：
{
"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"
}
}
}
}注： 如果uv找不到命令，运行which uv（Unix）或Get-Command uv（PowerShell）并使用中的完整路径"command"现场。
______________________________________________________________________
建筑
消息流
- Claude根据用户请求执行MCP工具
- MCP服务器处理工具调用
- OSC消息被格式化并发送到纯数据
- Pure Data通过动态补丁执行命令
- 反馈（如果有的话）通过OSC回调返回
故障排除
常见问题
- 对象创建失败：确保纯数据正在运行并且补丁已打开
- 连接问题：验证对象ID是否与返回的内容完全匹配
create_object - 端口冲突：检查端口5000是否已在使用中
- 消息格式错误：确保消息格式与纯数据补丁中的预期格式匹配
- 丢失的物品：如果对象跟踪混淆，请尝试重新启动MCP服务器和纯数据
JSON模式
这 pd-schema.json 为纯数据补丁提供了一个全面的数据模型，支持补丁的验证和序列化。虽然在当前的MCP工具中没有直接使用，但它为未来的开发和与补丁序列化/反序列化功能的潜在集成提供了参考。
后续步骤
- 增强的错误报告：改进纯数据的反馈，以获得更好的错误消息
- 可视化工具：添加工具以可视化当前补丁状态
- 对象库集成：支持加载外部库和抽象
- 补丁持久性：对补丁实施更好的状态管理
- 音频文件支持：添加用于处理音频文件和示例的工具
- MIDI集成：添加MIDI输入/输出功能
- GUI对象支持：添加对滑块和数字框等GUI对象的支持
- 协作功能：支持多个同时连接
- 文档生成器：从JSON模式创建自动文档
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
致谢
- 纯数据 -开源可视化编程语言
- 模型上下文协议 -支持AI工具的协议
- Python OSC -OSC的Python实现
