-
securityF
license-
qualityA Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
Last updated -
5
ソニックパイMCP
AIアシスタントがOSCメッセージを介してSonic Piと対話できるようにするModel Context Protocol（MCP）サーバー。これにより、ClaudeやCursorなどのAIツールが音楽を作成したり、Sonic Piをプログラムで制御したりできるようになります。
特徴
カスタマイズ可能なシンセパラメータで個々の音符を演奏する
任意のSonic Piコードを実行する
あらゆる MCP 互換クライアント (Claude Desktop、Cursor など) で動作します。
前提条件
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-inspector
MCP 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ファイルを参照してください。
local-only server
The server can only run on the client's local machine because it depends on local resources.
Claude や Cursor などの AI アシスタントが音楽を作成し、OSC メッセージを通じてプログラムで Sonic Pi を制御できるようにするモデル コンテキスト プロトコル サーバー。
Related MCP Servers
- AsecurityFlicenseAqualityA lightweight Model Context Protocol server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.Last updated -18149
- -securityFlicense-qualityA Model Context Protocol server that enables controlling Spotify playback through natural language commands in MCP clients like Cursor or Claude for Desktop.Last updated -2
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with Spotify, allowing them to search for tracks, control playback, and manage playlists.Last updated -1