Sonic Pi MCP
2025.04.05
4
TypeScript音乐创作AI辅助娱乐功能
Sonic Pi MCP 是一个模型上下文协议（MCP）服务器，允许AI助手通过OSC消息与Sonic Pi交互。这使得像Claude和Cursor这样的AI工具能够以编程方式创建音乐并控制Sonic Pi。
View on GitHub
Overview
基本能力
产品定位
Sonic Pi MCP 是一个桥梁服务，连接AI工具与音乐创作软件Sonic Pi，实现通过编程方式控制音乐生成。
核心功能
- 播放具有可定制合成器参数的单个音符
- 执行任意的Sonic Pi代码
- 与任何MCP兼容的客户端（如Claude Desktop、Cursor等）协同工作
适用场景
- AI辅助音乐创作
- 编程教育中的音乐编程
- 自动化音乐生成
工具列表
- play_note: 播放单个音符，可定制音符参数如音高、合成器类型、持续时间等。
- run_code: 执行任意的Sonic Pi代码，支持复杂的音乐模式和逻辑。
常见问题解答
- 无声音: 确保Sonic Pi正在运行，且OSC处理代码已激活。
- 连接错误: 检查是否有其他服务器实例正在运行，或端口4560是否被占用。
- 代码执行错误: 检查Sonic Pi日志窗口中的错误消息，确认代码语法正确。
使用教程
使用依赖
- 安装Bun:
curl -fsSL https://bun.sh/install | bash - 安装Sonic Pi (v4.0或更高版本)
- 准备一个MCP兼容的客户端（如Cursor或Claude Desktop）
安装教程
- 克隆仓库:
git clone https://github.com/abhishekjairath/sonic-pi-mcp.git - 进入项目目录:
cd sonic-pi-mcp - 安装依赖:
bun install - 启动开发服务器:
bun run dev
调试方式
- 使用MCP Inspector进行测试:
- 安装:
npm install -g @modelcontextprotocol/inspector - 启动:
mcp-inspector - 在浏览器中访问:
http://localhost:3000 - 测试工具:
- 使用
play_note工具播放音符 - 使用
run_code工具执行Sonic Pi代码