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 分

    请在仓库或注册中心条目中声明许可证。