音乐制作控制服务器

Cubase MCP Server 🎵

שרת MCP לשליטה בקיובייס (Steinberg Cubase) דרך Claude!

English | עברית

תוכן עניינים

• מה זה?
• יכולות מיוחדות
• התקנה
• שימוש
• כלים זמינים
• מגבלות ושיקולים
• תרומה לפרויקט
• רישיון

מה זה?

MCP Server שמאפשר ל-Claude לשלוט ב-Cubase בזמן אמת ולייצר מוזיקה. השרת משתמש ב-Virtual MIDI כדי לתקשר עם Cubase ויכול:

• ✅ לשלוט ב-Transport (play, stop, record)
• ✅ לשלוט במיקסר (volume, pan, mute, solo)
• ✅ ליצור קבצי MIDI עם נוטות, אקורדים ומלודיות
• ✅ ליצור שירים שלמים מתיאור טקסט! 🎼

יכולות מיוחדות

יצירת שיר שלם

"תיצור לי שיר פופ שמח ב-Key של C ב-120 BPM"

השרת יוצר:

• 🎹 מבנה אקורדים (chords.mid)
• 🎸 קו בס (bass.mid)
• 🎤 מלודיה (melody.mid)
• 🥁 תופים (drums.mid)

אחר כך פשוט מייבאים את הקבצים ל-Cubase!

התקנה

1. התקן את החבילות הנדרשות

pip install -r requirements.txt

2. הגדר Virtual MIDI Port (macOS)

1. פתח Audio MIDI Setup (/Applications/Utilities/)
2. לחץ על Window → Show MIDI Studio
3. לחץ פעמיים על IAC Driver
4. סמן "Device is online"

3. הגדר Generic Remote ב-Cubase

1. פתח את Cubase
2. לך ל-Studio → Studio Setup → Generic Remote
3. לחץ על "+" כדי להוסיף remote חדש
4. הגדר MIDI Input: Cubase MCP

מיפוי CC (Control Change):

4. הוסף את השרת ל-Claude Code

ערוך את קובץ ההגדרות של Claude Code (בדרך כלל ~/.config/claude-code/settings.json):

{
  "mcpServers": {
    "cubase": {
      "command": "python",
      "args": ["/Users/rontzarfati/Desktop/cubase mcp/server.py"]
    }
  }
}

או ב-Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cubase": {
      "command": "python",
      "args": ["/Users/rontzarfati/Desktop/cubase mcp/server.py"]
    }
  }
}

5. הפעל מחדש את Claude

שימוש

דוגמאות

שליטה ב-Transport

"תפעיל playback בקיובייס"
"תעצור את ההשמעה"
"תתחיל להקליט"

שליטה במיקסר

"תעלה את העוצמה של טראק 1 ל-100"
"תציב את הפאן של טראק 2 למרכז (64)"
"תעשה mute לטראק 3"
"תעשה solo לטראק 1"

יצירת קבצי MIDI

"תיצור סדרת נוטות: 60, 64, 67, 72 ותשמור ב-~/Desktop/melody.mid"
"תיצור progression אקורדים: C, Am, F, G ותשמור ב-~/Desktop/chords.mid"
"תיצור מלודיה עצובה ומלנכולית בסולם Am"

יצירת שיר שלם!

"תיצור שיר אופטימי ושמח ב-Key של C ב-tempo 128 BPM ותשמור ב-~/Desktop/my_song/"

זה יוצר 4 קבצי MIDI:

• chords.mid - פרוגרסיית אקורדים
• bass.mid - קו בס
• melody.mid - מלודיה
• drums.mid - תבנית תופים

זרימת עבודה מומלצת

1. תכנון: "תיצור לי שיר רוק אנרגטי ב-140 BPM"
2. יצירה: Claude יוצר את כל קבצי ה-MIDI
3. ייבוא: ייבא את הקבצים ל-Cubase (File → Import → MIDI File)
4. הקצאת כלים: הוסף VST instruments לכל טראק
5. עיצוב: השתמש ב-Claude כדי לשלוט במיקסר ולהקליט

כלים זמינים

🎵 Transport Controls

• transport_play() - הפעל playback
• transport_stop() - עצור playback
• transport_record() - התחל הקלטה
• transport_rewind() - חזור להתחלה
• transport_forward() - קפוץ קדימה

🎚️ Mixer Controls

• mixer_set_volume(track, volume) - קבע עוצמה (0-127)
• mixer_set_pan(track, pan) - קבע pan (0=שמאל, 64=מרכז, 127=ימין)
• mixer_mute_track(track, mute) - השתק/בטל השתקה
• mixer_solo_track(track, solo) - solo/בטל solo

🎹 MIDI Creation

• create_midi_note_sequence() - צור סדרת נוטות
• create_midi_chord_progression() - צור פרוגרסיית אקורדים
• create_midi_melody() - צור מלודיה מתיאור

🎼 Song Creation

• create_song_structure() - צור שיר שלם עם:
  • אקורדים
  • בס
  • מלודיה
  • תופים

ℹ️ Information

• get_setup_instructions() - מדריך התקנה מפורט
• list_available_tools() - רשימת כל הכלים

מגבלות ושיקולים

מה עובד מצוין ✅

• Transport control (play/stop/record)
• Mixer control (volume/pan)
• יצירת קבצי MIDI מורכבים
• יצירת שירים מתיאורים

מה דורש עבודה ידנית 🔧

• ייבוא קבצי MIDI ל-Cubase (לא ניתן לאוטומציה)
• הוספת VST instruments
• עריכה מפורטת של MIDI clips
• אפקטים ו-mixing מתקדם

הרחבות עתידיות 🚀

• תמיכה ב-MIDI Remote API (JavaScript)
• עריכה ישירה של קבצי .cpr (דורש reverse engineering)
• אינטגרציה עם מודלי AI ליצירת מוזיקה
• תמיכה במבני שירים מורכבים יותר

פתרון בעיות

"Failed to create MIDI port"

• ודא ש-IAC Driver מופעל ב-Audio MIDI Setup
• נסה להפעיל מחדש את המחשב

"Failed to start playback"

• בדוק את הגדרות Generic Remote ב-Cubase
• ודא שה-MIDI Input מוגדר ל-"Cubase MCP"
• בדוק שה-CC mappings נכונים

קבצי MIDI לא מתנגנים

• ודא שייבאת את הקבצים לטראקים הנכונים
• הוסף VST instrument לכל טראק
• בדוק את canal routing

תמיכה

יש בעיה או רעיון לשיפור? פתח issue או שלח pull request!

תרומה לפרויקט

רוצה לתרום? מעולה!

1. קרא את CONTRIBUTING.md
2. Fork את הפרויקט
3. צור branch חדש (git checkout -b feature/amazing-feature)
4. Commit את השינויים (git commit -m 'Add amazing feature')
5. Push ל-branch (git push origin feature/amazing-feature)
6. פתח Pull Request

רעיונות לתרומות

• 🎹 הוסף אקורדים ומבנים מוזיקליים נוספים
• 🎼 שפר את אלגוריתמי יצירת המלודיות
• 🔧 הוסף תמיכה ב-Windows/Linux
• 📚 תרגם תיעוד לשפות נוספות
• 🐛 דווח על באגים ותקן אותם

רישיון

MIT License - ראה LICENSE לפרטים מלאים.

קרדיטים

• נבנה עם MCP
• Virtual MIDI דרך mido ו-python-rtmidi
• עבור Steinberg Cubase

נבנה עם ❤️ על ידי Claude Code

🎵 Happy Music Making! 🎵

Star History

אם הפרויקט עזר לך, אנא תן ⭐️ ב-GitHub!