Atlas / MCP servers / brightlikethelight / Music21

Music21CAUTION

mcp/brightlikethelight/music21-1

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

Verdict
CAUTION
Grade
B
Trust score
83 /100
Exposed tools
14 12r · 1w · 1d
Transport
—
License
MIT
Stars
26
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://github.com/brightlikethelight/music21-mcp-server/actions/workflows/ci.yml) [](https://github.com/brightlikethelight/music21-mcp-server/actions/workflows/ci.yml) [](https://github.com/brightlikethelight/music21-mcp-server/actions) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://github.com/astral-sh/ruff) [](https://modelcontextprotocol.io)

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
Read from source at commit b28e6ea4c616OBSERVED · 2026-10-09
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code
claude mcp add music21-mcp-server -- uvx music21-mcp-server
claude-desktop
{
  "mcpServers": {
    "music21-mcp-server": {
      "command": "uvx",
      "args": [
        "music21-mcp-server"
      ]
    }
  }
}
03

Exposed tools (14)

12 read · 1 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

ToolRiskDescription
chord_analysisreadAnalyze chord progressions in a score
delete_scoredestructiveDelete a score from storage
export_scorereadExport a score to various formats
generate_counterpointreadGenerate species counterpoint (1=note-against-note, 2=2:1, 3=3:1, 4=syncopated, 5=florid)
harmonize_melodyreadGenerate harmonization for a melody in various styles (classical, jazz, pop, modal)
harmony_analysisreadPerform harmony analysis (roman numeral or functional)
health_checkreadCheck server and adapter health
imitate_stylereadGenerate music imitating a specific composer style (bach, mozart, chopin, debussy) or analyze score for style
import_scorewriteImport a score from various sources
key_analysisreadAnalyze the key signature of a score
list_scoresreadList all available scores
pattern_recognitionreadRecognize patterns in music
score_inforeadGet detailed information about a score
voice_leading_analysisreadAnalyze voice leading patterns in a score
04

Trust audit

CAUTIONgrade B · trust 83/100 Install with care. The audit found things worth knowing before you trust its output.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeWARN
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfaceWARN
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (5 observation(s))
Network
none-observed
Shell
declared (2 observation(s))
Dependencies
not all pinned
Secrets in source
none-found

Findings (18)

MEDIUMCode injection · code.dynamic_import · CWE-78, CWE-94, CWE-95
src/music21_mcp/health_checks.py:347
module = __import__(dep_name)
MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
delete_score
Why it matters. 1 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius
LOWInventory / provenance · inv.hidden_file · CWE-1104
.pre-commit-config.yaml
.pre-commit-config.yaml
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/music21_mcp/performance_cache.py:78
return hashlib.md5(cache_key_data.encode(), usedforsecurity=False).hexdigest()
LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/music21_mcp/performance_cache.py:244
score_hash = hashlib.md5(
LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/music21_mcp/performance_cache.py:253
score_hash = hashlib.md5(
LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/music21_mcp/performance_optimizations.py:263
return hashlib.md5(str(pitches).encode(), usedforsecurity=False).hexdigest()[
LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338
src/music21_mcp/performance_optimizations.py:636
score_hash = hashlib.md5(
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
tests/integration/test_production_failures.py:652
"../../../etc/passwd",  # Path traversal attempt
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
tests/unit/test_import_tool_security.py:19
tool._validate_safe_path("../../etc/passwd")
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
tests/unit/test_import_tool_security.py:37
tool._validate_safe_path("/var/log/../../../etc/shadow")
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
tests/unit/test_security.py:70
"../../../etc/passwd",
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
tests/unit/test_security.py:91
"../../../etc/passwd",
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
dxt/requirements.txt
music21, numpy, pydantic, cachetools, psutil, mcp, fastmcp, fastapi
Why it matters. 9 requirement(s) not pinned with ==
Fix. pin exact versions
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
.github/webhook-config.md:39
**⚠️ Security Note**: Keep this URL secret! Anyone with this URL can send messages to your Discord channel.
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
INFOPrompt injection · prompt.authority_framing · CWE-94, CWE-1427
SECURITY.md:48
- Never run with elevated privileges unless absolutely necessary
INFOSupply chain · prompt.pipe_to_shell · CWE-829, CWE-1357
README.md:62
curl -LsSf https://astral.sh/uv/install.sh | sh
INFOSupply chain · prompt.pipe_to_shell · CWE-829, CWE-1357
docs/getting-started.md:26
curl -LsSf https://astral.sh/uv/install.sh | sh

Gates applied: no_behavioural_pass.

Audited 2026-10-09 · audit v0.4.1 · source sha b28e6ea4c616full audit observations/trust-audit/mcp-server/brightlikethelight__music21-1.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-09b28e6ea4c616CAUTIONB83first audit
06

Questions

What is the Music21 MCP server?

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

What tools does Music21 expose?

14 in total: 12 read-only, 1 that write, and 1 that can delete or overwrite (delete_score). Every one is listed on this page with its risk.

Is Music21 safe to connect to an agent?

With care. The audit graded it B (83/100) and found 18 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does Music21 need?

No credential environment variables were found in its source, so it appears to need none.

How current is this page?

The grade is for one exact copy of the source (b28e6ea4c616), read on 2026-10-09. The repository is watched and re-audited when it changes.

Advertisement