Music Form Analysis — MCP Tool
Analyze music structure, tonality, harmony, and form directly from Claude Desktop, Cursor, or any MCP-compatible AI agent.
MCP Tool: analyze_music
AI-powered musicological analysis that identifies key signatures, time signatures, sections, harmonic progressions, and overall musical form.
Parameters
mxl_file_url — URL of a MusicXML (.mxl) fileimage_url — URL of a sheet music imagepdf_file_url — URL of a PDF scorelanguage — Analysis language: "en", "zh", "ja", etc. (default: "en")How It Works
Get music analysis in your AI chat.
Configure MCP
Add the Melogen MCP server URL and your API key to your AI agent's settings.
Ask Your AI
Say: "Analyze the structure of this score" and provide a file URL.
Get Analysis
Your AI receives a detailed structural analysis including key, form, and harmony.
Usage Example
Here's how the analysis tool call works.
Example prompt to your AI agent:
“Analyze the harmonic structure of this score: https://example.com/score.mxl”
// MCP Tool Call (handled automatically by your AI agent)
{
"tool": "analyze_music",
"arguments": {
"mxl_file_url": "https://example.com/score.mxl",
"language": "en"
}
}
// Response
{
"status": "completed",
"analysis": "Key: C Major\nTime Signature: 4/4\nForm: Sonata-Allegro\n\nExposition (mm. 1-45):\n First Theme (mm. 1-16): Energetic, scalar\n Transition (mm. 17-28): Modulates to G Major\n Second Theme (mm. 29-45): Lyrical, contrasting\n\nDevelopment (mm. 46-78):\n Fragmentation of first theme material...",
"language": "en",
"message": "Music form analysis completed successfully."
}Why Use This MCP Tool?
Get deep musicological analysis directly in your AI chat. Understand form, harmony, and structure from scores and images.
Deep Musicological Analysis
Goes beyond basic key detection — identifies form, sections, and harmonic language.
Multiple Input Types
Analyze from MusicXML, images, or PDFs — whichever you have.
Multilingual Output
Get analysis results in your preferred language.
Discuss with AI
Your AI can discuss the analysis, answer follow-up questions, and provide musical insights.
Frequently Asked Questions
Common questions about the Music Analysis MCP tool.
The analysis covers key signature, time signature, musical form (sonata, rondo, binary, etc.), section identification, harmonic progressions, cadences, and modulations.
Analysis results can be in English, Chinese, Japanese, and other languages. Set the 'language' parameter to your preferred language code.
MusicXML files give the most accurate analysis since they contain structured note data. Images and PDFs are first converted via OMR, which may introduce some errors.
Yes, the analysis supports multi-voice, multi-instrument scores. Complex orchestral works are analyzed at a higher structural level.
Music Form Analysis — MCP Tool
Analyze music structure, tonality, harmony, and form directly from Claude Desktop, Cursor, or any MCP-compatible AI agent.
Get API Key