ソニックパイMCP
AIアシスタントがOSCメッセージを介してSonic Piと対話できるようにするModel Context Protocol（MCP）サーバー。これにより、ClaudeやCursorなどのAIツールが音楽を作成したり、Sonic Piをプログラムで制御したりできるようになります。
特徴
カスタマイズ可能なシンセパラメータで個々の音符を演奏する
任意のSonic Piコードを実行する
あらゆる MCP 互換クライアント (Claude Desktop、Cursor など) で動作します。
Related MCP server: Spotify MCP Server
前提条件
Sonic Piの設定
MCPサーバーを使用する前に、Sonic Piのバッファに以下のコードを追加する必要があります。このコードは、サーバーから送信されるOSCメッセージを処理します。
# Required Sonic Pi configuration
# Add this to a buffer in Sonic Pi and run it
live_loop :code_runner do
use_real_time
code = sync "/osc*/run-code"
# Since we receive the code as a string, we can use eval to execute it
# The code comes as the first element of the message
begin
eval(code[0].to_s)
rescue Exception => e
puts "Error executing code: #{e.message}"
end
end
MCP サーバーを使用する前に、このコードが Sonic Pi で実行されていることを確認してください。
クライアントとの統合
カーソル
~/.cursor/mcpServers.jsonに追加:
{
"mcpServers": {
"sonic_pi_mcp": {
"name": "Sonic Pi MCP",
"command": "npx",
"args": ["-y", "sonic-pi-mcp", "start"],
"transport": {
"type": "stdio"
}
}
}
}クロードデスクトップ
Claude の MCP 構成に追加:
{
"mcpServers": {
"sonic_pi_mcp": {
"command": "npx",
"args": ["-y", "sonic-pi-mcp", "start"]
}
}
}利用可能なツール
プレイノート
カスタマイズ可能なパラメータを使用して単音を再生します。
パラメータ:
note（必須）: MIDIノート番号（0～127）synth(オプション): 使用するシンセ (例: ":saw", ":beep", ":prophet")sustain（オプション）：音符の長さ（秒）（デフォルト：1）cutoff（オプション）：フィルタのカットオフ周波数（デフォルト：100）
例：
// Play middle C with saw wave synth
{
"name": "play_note",
"parameters": {
"note": 60,
"synth": ":saw",
"sustain": 0.5,
"cutoff": 80
}
}実行コード
任意の Sonic Pi コードを実行します。
パラメータ:
code（必須）: 実行するSonic Piコード
例：
{
"name": "run_code",
"parameters": {
"code": "use_synth :prophet\nplay_pattern_timed [60, 64, 67], [0.5]"
}
}使用例
MCP ツールを使用したインタラクションの例を次に示します。
シンプルなメロディー
// Play a C major arpeggio
{
"code": `
use_synth :piano
play_pattern_timed [60, 64, 67, 72], [0.25], release: 0.1
`
}複雑なパターン
// Create a rhythmic pattern
{
"code": `
live_loop :rhythm do
use_synth :tb303
play choose(chord(:C3, :minor)), release: 0.2, cutoff: rrand(60, 120)
sleep 0.25
end
`
}トラブルシューティング
音が出ない
Sonic Piが動作していることを確認する
Sonic PiでOSCハンドラーコードが実行されていることを確認します。
Sonic Piがポート4560（デフォルト）でリッスンしていることを確認する
接続エラー
サーバーの別のインスタンスが実行中かどうかを確認します
Sonic Piを再起動する
他のアプリケーションがポート4560を使用していないことを確認する
コード実行エラー
Sonic Piのログウィンドウでエラーメッセージを確認します
Sonic Piコードの構文を検証する
必要なシンセサイザーとサンプルがすべて利用可能であることを確認する
発達
# Clone the repository
git clone https://github.com/abhishekjairath/sonic-pi-mcp.git
cd sonic-pi-mcp
# Install dependencies
npm install
# Build
npm run build
# Install MCP Inspector globally (for testing)
npm install -g @modelcontextprotocol/inspector
# Start Sonic Pi and run the OSC handler code (see Sonic Pi Configuration section)
# Start the server in one terminal
npm run dev
# In another terminal, start the MCP Inspector
mcp-inspectorMCP Inspectorによるテスト
ブラウザを開き、 http://localhost:3000にアクセスします。
MCP Inspector UI で、接続を構成します。
コマンド:
node引数:
dist/server.mjs作業ディレクトリ:
/path/to/your/sonic-pi-mcp(実際のプロジェクト パスを使用)トランスポートタイプ: stdio
play_noteツールをテストします。
{
"name": "play_note",
"parameters": {
"note": 60,
"synth": ":beep",
"sustain": 0.5
}
}run_codeツールをテストします。
{
"name": "run_code",
"parameters": {
"code": "use_synth :prophet\nplay_pattern_timed scale(:c4, :major), [0.25]"
}
}Sonic Piのログウィンドウでエラーメッセージや出力を確認します
開発上の問題のトラブルシューティング
ビルドエラー
npm run buildを実行し、TypeScript エラーを確認します。すべての依存関係が正しくインストールされていることを確認する
tsconfig.jsonで適切な設定を確認してください
MCPインスペクターの接続の問題
サーバーが実行中であることを確認します (
npm run dev)作業ディレクトリのパスが正しいことを確認してください
サーバーの他のインスタンスが実行されていないことを確認する
OSC通信の問題
Sonic Piが実行中であり、OSCハンドラーコードがアクティブであることを確認します。
サーバーログで接続エラーを確認してください
ポート4560が利用可能であり、ブロックされていないことを確認します
貢献
リポジトリをフォークする
機能ブランチを作成します（
git checkout -b feature/amazing-feature）変更をコミットします (
git commit -m 'Add some amazing feature')ブランチにプッシュする (
git push origin feature/amazing-feature)プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。