{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_quzs3v7d5dyc","handle":"mcp-local-music-analysis","url":"https://wellknown.network/agents/mcp-local-music-analysis","links":{"self":"https://wellknown.network/agents/mcp-local-music-analysis/record.json","html":"https://wellknown.network/agents/mcp-local-music-analysis","markdown":"https://wellknown.network/agents/mcp-local-music-analysis/record.md","api":"https://wellknown.network/api/v1/agents/mcp-local-music-analysis","status":"https://wellknown.network/api/v1/agents/mcp-local-music-analysis/status","claim":"https://wellknown.network/agents/mcp-local-music-analysis/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-local-music-analysis/claim.json","badge":"https://wellknown.network/agents/mcp-local-music-analysis/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-local-music-analysis/history","tools":"https://wellknown.network/api/v1/agents/mcp-local-music-analysis/tools"},"ard":{"identifier":"urn:air::server:mcp-local-music-analysis","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-local-music-analysis","summary":"Local MCP server for music and audio analysis with librosa.","description":"# MCP Local Music Analysis\n\nLocal Model Context Protocol server for music and audio analysis with\n[`librosa`](https://librosa.org/). It exposes one comprehensive analysis tool\nfor local audio files.\n\n## Setup\n\nAdd this server to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"music-analysis\": {\n      \"command\": \"uvx\",\n      \"args\": [\"-n\", \"mcp_local_music_analysis\"]\n    }\n  }\n}\n```\n\nThe package is installed and launched by `uvx`. The server defaults to stdio\ntransport, which is what Claude Desktop and other subprocess-based MCP clients\nexpect.\n\nThe command also supports HTTP for clients that connect over a local streamable\nHTTP endpoint:\n\n```bash\nuvx -n mcp_local_music_analysis --transport http\n```\n\nThe HTTP server listens on `127.0.0.1:8000` by default. Override that with:\n\n```bash\nLIBROSA_MCP_HOST=0.0.0.0 LIBROSA_MCP_PORT=8000 uvx -n mcp_local_music_analysis --transport http\n```\n\n## Tools\n\nThe server exposes one MCP tool:\n\n- `full_analysis(file_path)`: run duration, tempo, beat timestamps, key, pitch-class energy, MFCC means/stds, and spectral analysis in one call.\n\n`full_analysis` returns:\n\n- file name and sample rate\n- duration in seconds and formatted time\n- tempo, tempo description, beat count, and beat timestamps\n- estimated key and pitch-class energy\n- 13 MFCC coefficients with mean and standard deviation\n- spectral centroid, bandwidth, rolloff, zero-crossing rate, RMS energy, and brightness\n\nExample output:\n\n```json\n{\n  \"file\": \"track.mp3\",\n  \"sample_rate_hz\": 44100,\n  \"duration\": {\n    \"seconds\": 183.742,\n    \"formatted\": \"3:03.74\"\n  },\n  \"rhythm\": {\n    \"tempo_bpm\": 128.0,\n    \"tempo_description\": \"Allegro / fast\",\n    \"num_beats\": 390,\n    \"beat_times_seconds\": [0.51, 0.975, 1.44]\n  },\n  \"harmony\": {\n    \"estimated_key\": \"A minor\",\n    \"pitch_class_energy\": {\n      \"C\": 0.6214,\n      \"C#\": 0.2841,\n      \"D\": 0.4472,\n      \"D#\": 0.1985,\n      \"E\": 0.7319,\n      \"F\": 0.5128,\n      \"F#\": 0.2663,\n      \"G\": 0.6894,\n      \"G#\": 0.3912,\n     …","publisher":{"name":"Joe","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp","music","audio","librosa","analysis"],"pricing":null,"endpoints":[{"url":"pypi:mcp-local-music-analysis","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.music","name":"Music & Audio","confidence":1,"provenance":"declared"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-local-music-analysis","registry":"pypi","observedAt":"2026-11-03T14:23:51.170Z","publishedAt":"2026-05-23T15:12:16.190706Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-local-music-analysis","url":"https://pypi.org/project/mcp-local-music-analysis/","firstSeenAt":"2026-09-10T02:23:25.025Z","fetchedAt":"2026-11-03T14:22:01.816Z","normalizedAt":"2026-11-03T14:22:01.816Z"}]},"firstSeenAt":"2026-09-10T02:23:25.025Z","updatedAt":"2026-11-03T14:23:51.170Z"}