brightlikethelight/music21-mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

28 stars 9 forks Качество 72 Тренд 15MIT

🎵 Production-ready MCP server for music analysis & generation | FastMCP • music21 • OAuth2 • Docker | First music21 MCP integration with enterprise features

Обзор

- MCP server, HTTP API, CLI tools, and Python library. Built on the powerful music21 library with protocol-independent architecture for maximum reliability. Based on 2025 research showing , this project provides to the same powerful music21 analysis functionality: - 📡 - For Claude Desktop integration (when it works) - 🌐 - For web applications (reliable backup) - 💻 - For automation (always works) - 🐍 - For direct programming access - : MusicXML, MIDI, ABC, Lilypond, music21 corpus - : Multiple algorithms (Krumhansl, Aarden, Bellman-Budge) - : Roman numerals, chord progressions, cadence detection - : Parallel motion detection, voice crossing analysis - : Melodic, rhythmic, and harmonic patterns - : Bach chorale and jazz style harmonization - : Species counterpoint generation (1-5) - : Learn and generate music in composer styles - : Transposition, time stretching, orchestration - : Music21 analysis isolated from protocol concerns - : Works even when MCP fails (30-40% of time) -...

README

Показан фрагмент оригинального README. Открыть оригинал.

Music21 Analysis - Multi-Interface Music Server

Professional music analysis with 4 different interfaces - MCP server, HTTP API, CLI tools, and Python library. Built on the powerful music21 library with protocol-independent architecture for maximum reliability.

🎯 Why Multiple Interfaces?

Based on 2025 research showing MCP has 40-50% production success rate, this project provides multiple pathways to the same powerful music21 analysis functionality:

📡 MCP Server - For Claude Desktop integration (when it works)
🌐 HTTP API - For web applications (reliable backup)
💻 CLI Tools - For automation (always works)
🐍 Python Library - For direct programming access

🎵 Core Music Analysis Features

Analysis Tools (13 Available)

Import & Export: MusicXML, MIDI, ABC, Lilypond, music21 corpus
Key Analysis: Multiple algorithms (Krumhansl, Aarden, Bellman-Budge)
Harmony Analysis: Roman numerals, chord progressions, cadence detection
Voice Leading: Parallel motion detection, voice crossing analysis
Pattern Recognition: Melodic, rhythmic, and harmonic patterns

Advanced Capabilities

Harmonization: Bach chorale and jazz style harmonization
Counterpoint: Species counterpoint generation (1-5)
Style Imitation: Learn and generate music in composer styles
Score Manipulation: Transposition, time stretching, orchestration

🚀 Quick Start

Installation

Install from PyPI (Recommended)

# Install the package
pip install music21-mcp-server

# Start the server
music21-mcp          # MCP server for Claude Desktop
music21-http         # REST API at localhost:8000
music21-cli          # Interactive CLI
music21-analysis mcp          # Unified launcher (positional arg)

Install from Source

# Clone repository
git clone https://github.com/brightlikethelight/music21-mcp-server.git
cd music21-mcp-server

# Install with UV (recommended)

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

# Start MCP server
python -m music21_mcp.launcher mcp

# Configure Claude Desktop with:
# ~/.config/claude-desktop/config.json
{
  "mcpServers": {
    "music21-analysis": {
      "command": "python",
      "args": ["-m", "music21_mcp.server_minimal"],
      "env": {
        "PYTHONPATH": "/path/to/music21-mcp-server/src"
      }
    }
  }
}