Tracktag Mcp

io.github.adigold由 GitHub 帳號 adigold 發布v0.2.0更新於 Oct 28, 2026

AI music analysis for agents: BPM, key, genres, moods, instruments and 35+ tags per track.

已驗證STDIO僅桌面媒體與設計AI 與機器學習

概覽

AI 產生的概覽

TrackTag MCP 讓助理透過 TrackTag API 分析音訊檔案或連結,回傳 BPM、調性、曲風、情緒、樂器及 35 項以上中繼資料。

可以做什麼
  • 分析本機音訊檔案(mp3、wav、flac、aiff、m4a、ogg),回傳 BPM、調性、曲風、情緒、樂器、能量及 35 項以上中繼資料
  • 分析來自 https 連結的音訊
  • 查詢剩餘額度與限制
  • 列出最近的 API 分析紀錄
  • 逐首呼叫分析工具並彙整結果,完成小批量處理
適用情境
適合需要助理為曲目、同步授權曲庫或音樂市集產生一致、可用於目錄的音樂中繼資料,而不是依檔名猜測的情境。較適合對話式、少量曲目的處理;大批目錄工作建議改用 TrackTag Studio 或 API。
執行需求
作為本機程序由 MCP 用戶端啟動(npx tracktag-mcp,或 Claude Desktop 一鍵安裝包)。需要 TrackTag API 金鑰,透過環境變數 TRACKTAG_API_KEY 提供,可在 TrackTag studio 建立,也提供免費測試金鑰。分析時需要連線至 TrackTag 的網路存取。
安裝前請注意
分析會從 TrackTag 額度餘額扣費(core 模型每首 1 點,ultra 每首 2 點),分析失敗會自動退還。API 金鑰屬機密,透過環境變數傳入。音訊檔案或連結會傳送至 TrackTag 進行分析。預設速率限制為每分鐘 10 次請求。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tracktag Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

TrackTag MCP Server

Let AI agents (Claude Desktop, Claude Code, Cursor, and any MCP-capable client) analyze music with TrackTag: drop an MP3 into your agent, say "analyze this track", and get BPM, key, genres, moods, instruments, energy and 35+ metadata fields back.

Runs entirely on your own computer — your agent app starts it, talks to it directly (no middleman server, so your audio and API key never leave your machine on the way to TrackTag), and stops it when you quit. Analyses are billed from your TrackTag credit balance (1 credit per track with the core model, 2 with ultra); failed analyses are refunded automatically.

Setup

First, get an API key: tracktag.me/studio → API & MCP → Create key (tt_live_…). Free test keys available.

⚡ One-click install (Claude Desktop) — recommended

Download tracktag.mcpb → double-click it → Claude Desktop opens an install window → paste your API key → done. No config files, no Node.js, nothing to edit. (One Claude quirk: after installing, flip the extension ON in Settings → Extensions.)

Manual config (Cursor, Claude Code, other MCP clients)

Add the server to your agent's MCP config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

json
{  "mcpServers": {    "tracktag": {      "command": "npx",      "args": ["-y", "tracktag-mcp"],      "env": { "TRACKTAG_API_KEY": "tt_live_YOUR_KEY" }    }  }}

Claude Code:

bash
claude mcp add tracktag -e TRACKTAG_API_KEY=tt_live_YOUR_KEY -- npx -y tracktag-mcp

Cursor (~/.cursor/mcp.json): same JSON block as Claude Desktop.

Tools

ToolWhat it doesCost
analyze_trackAnalyze a local audio file (mp3/wav/flac/aiff/m4a/ogg, ≤15 MB)1–2 credits
analyze_urlAnalyze audio from any https URL (≤60 MB)1–2 credits
get_creditsRemaining credit balance and limitsfree
list_recent_jobsRecent API analysesfree

Docs

Full API reference: tracktag.me/developers

Can I analyze multiple tracks? (batching)

Yes — small batches work right in the chat. Drop several audio files into your assistant (or name a folder's worth of tracks) and say "analyze all of these with TrackTag" — the agent calls the analysis tool once per track and summarizes the results together. Each track bills its own credit, and the default rate limit (10 requests/minute) makes this comfortable for a handful of tracks at a time.

For real catalog work, use the tools built for it: TrackTag Studio runs 100-file batches with folders, progress tracking and XLSX/CSV/XML exports, and the TrackTag API handles high-volume pipelines with async jobs and webhooks. Same engine, same credits — pick the surface that fits the job: MCP for conversation, Studio for catalogs, API for automation.

"Can't I just drag the MP3 into ChatGPT or Claude and ask?"

Not if you want real, reliable metadata — and here's the honest breakdown.

Claude cannot hear audio, and ChatGPT doesn't musically analyze it. Drop an MP3 into a Claude chat and it sees the file's name and metadata — it never processes the actual sound. ChatGPT will at best transcribe any speech in the file; it won't tell you the key, the groove or the instrumentation from the waveform. Whatever "analysis" comes back is largely an educated guess from the title. This MCP server is what gives your assistant real ears.

Some models can accept audio — but a raw model is not an analysis product. TrackTag runs every track through a purpose-built pipeline: audio preprocessing, signal-level analysis of the actual waveform (tempo, tonality, timbre, instrumentation, vocal characteristics, dynamics), an extraction process tuned specifically for music metadata, and validation of every result against a strict 35+ field taxonomy with controlled vocabulary. A one-off chat prompt gives you different fields, different wording and different judgments every single run — fine for curiosity, useless for a catalog.

Consistency is the product. Sync libraries, marketplaces and labels need the same schema, the same vocabulary and the same standards across 10 or 10,000 tracks — plus batch handling and automatic refunds when an analysis fails. That's engineering around the model, not the model itself, and it's what you're getting here.

Your AI assistant does what it's great at — conversation and workflow. TrackTag does what it's built for — turning sound into professional, uniform metadata.

About the creator

TrackTag is built by Adi Goldstein — a composer and music producer based in Tel Aviv who has spent years on both sides of the problem: writing and licensing music, and wrestling with the metadata that makes it findable. TrackTag exists because tagging a catalog by hand is the least musical part of making music.

It's part of a family of tools Adi builds for musicians and creators:

ProjectWhat it does
TrackTagAI music tagging — BPM, key, genres, moods and 35+ metadata fields per track, for catalogs, sync libraries and now AI assistants
AGsoundtraxCurated royalty-free music library for filmmakers, video creators and commercial producers
PromoLinksSmart links and artist pages for musicians — one URL that routes fans to their preferred streaming platform, with pre-saves and analytics
MakeCanvasAI-generated Spotify Canvas videos — looping visuals for your tracks, no video editing needed
AG WatermarkAudio watermarking to protect tracks and demos before they're licensed

Questions, ideas, or building something with the TrackTag API? Reach out via tracktag.me/support.

來源:README.md,提交 e04c784

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。