[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81566":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":13,"forks30d":13,"starsTrendScore":17,"compositeScore":13,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":19,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":13,"starSnapshotCount":13,"syncStatus":15,"lastSyncTime":27,"discoverSource":28},81566,"audio-file-mcp-app","counterpoint-studio\u002Faudio-file-mcp-app","counterpoint-studio","An MCP App for playing and inspecting local audio files in an MCP host.","",null,"TypeScript",29,0,24,2,5,6,"ISC License",false,"main",[22,23],"audio","mcp","2026-06-12 02:04:16","# Audio File MCP App\n\nAn [MCP App](https:\u002F\u002Fblog.modelcontextprotocol.io\u002Fposts\u002F2026-01-26-mcp-apps\u002F)\nfor playing and inspecting local audio files in an MCP host.\n\n![Audio File MCP App running in Claude Desktop](https:\u002F\u002Fraw.githubusercontent.com\u002Fcounterpoint-studio\u002Faudio-file-mcp-app\u002Fmain\u002Fdocs\u002Fscreenshot.png)\n\nRenders an in-conversation UI with playback, metadata, loudness, and a\nspectrogram.\n\nFile metadata, loudness statistics, the current playhead\nposition, and any selected region are also exposed back to the model, so\nfollow-up tasks can refer to what the user is actually hearing and looking at.\n\n## Features\n\n- **Global loudness metrics** computed to EBU R128: Integrated Loudness\n  (LUFS), Loudness Range (LRA), True Peak (dBTP), Sample Peak, and RMS.\n- **Instantaneous loudness metrics** while playing or hovering: Momentary\n  (400 ms) and Short-Term (3 s) LUFS, plus sample-peak and RMS at the\n  cursor position.\n- **Waveform colouring** by spectral centroid — each waveform slice is\n  shaded along a tonal ramp using a low\u002Fmid\u002Fhigh band-energy ratio, so\n  bright\u002Fdark regions read at a glance as bright\u002Fdark sound.\n- **Reassigned spectrogram** with log-frequency bins (20 Hz floor) and an\n  Inferno colour scale; time-frequency reassignment sharpens transients\n  and tonal partials beyond what a plain STFT shows.\n- **Looping region selection.** Drag on the timeline to mark a region;\n  playback loops over it, and the region's start\u002Fend are passed back to\n  the model alongside the file's loudness and playhead state.\n\n## Install\n\nThe server runs locally over stdio. Every install path below configures the\nsame command: `npx -y @counterpoint-studio\u002Faudio-file-mcp-app`.\n\n### Claude Desktop\n\nEasiest: grab the latest `.mcpb` from the\n[Releases page](https:\u002F\u002Fgithub.com\u002Fcounterpoint-studio\u002Faudio-file-mcp-app\u002Freleases\u002Flatest)\nand double-click it. Claude Desktop has Node bundled, so no extra runtime\nis needed.\n\nOr add the server by hand to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"audio-file\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@counterpoint-studio\u002Faudio-file-mcp-app\"]\n    }\n  }\n}\n```\n\n### VS Code (Copilot, Agent mode)\n\n[![Install in VS Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall%20in-VS%20Code-007ACC?logo=visualstudiocode&logoColor=white)](https:\u002F\u002Finsiders.vscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=audio-file&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40counterpoint-studio%2Faudio-file-mcp-app%22%5D%7D)\n\nOr add to `.vscode\u002Fmcp.json` (workspace) or your user `mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"audio-file\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@counterpoint-studio\u002Faudio-file-mcp-app\"]\n    }\n  }\n}\n```\n\n### Goose\n\nPaste this deep link into your browser (Goose Desktop must be installed; the\ncustom URI scheme can't be a real link in a GitHub README):\n\n```\ngoose:\u002F\u002Fextension?id=audio-file&name=Audio%20File%20MCP%20App&cmd=npx&arg=-y&arg=%40counterpoint-studio%2Faudio-file-mcp-app\n```\n\nOr run `goose configure` → **Add Extension** → **Command-line Extension** and\nenter `npx -y @counterpoint-studio\u002Faudio-file-mcp-app`.\n\n### MCP Inspector\n\n```bash\nnpx @modelcontextprotocol\u002Finspector npx -y @counterpoint-studio\u002Faudio-file-mcp-app\n```\n\n## Usage\n\nAsk the host to show you a local audio file by its absolute path. For\nexample:\n\n> \"Show me `\u002FUsers\u002Fme\u002FMusic\u002Ftrack.wav`\"\n\nThe host calls the `display_audio_file` tool, which renders the in-app UI\nwith waveform, spectrogram, loudness metrics, and playback transport.\n\n## Client compatibility\n\nTested and known to work in:\n\n- **Claude Desktop** — Chat and Cowork\n- **Visual Studio Code**\n- **Goose**\n- **MCP Inspector**\n\nThe Codex app has been tested too, but\n[its MCP App support is currently broken](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex\u002Fissues\u002F21019).\n\n## Development\n\n```bash\npnpm install\npnpm run build:dsp   # emsdk required; see WASM-BUILD.md\npnpm run serve       # runs the server with tsx, no compile step\npnpm test\n```\n\n`pnpm run build:dist` produces the publishable layout under `dist\u002F`\n(`dist\u002Fmcp-app.html` + `dist\u002Fserver\u002F`).\n\n## Releasing\n\n```bash\npnpm version \u003Cbump>                                 # bumps package.json + tags\npnpm publish --access public                        # publishes to npm\npnpm run build:mcpb                                 # produces dist\u002Faudio-file-mcp-app-\u003Cversion>.mcpb\ngh release create v\u003Cversion> dist\u002F*.mcpb           # attaches the bundle to a GitHub release\nmcp-publisher login github && mcp-publisher publish # updates the MCP Registry listing\n```\n\n`mcp-publisher` is a Go binary; install it via\n`brew install mcp-publisher` or per the\n[registry quickstart](https:\u002F\u002Fmodelcontextprotocol.io\u002Fregistry\u002Fquickstart).\nIt reads `server.json` from the repo root — keep its `version` in sync with\n`package.json` before publishing.\n\n## License\n\nISC © Counterpoint Studio OÜ\n","这是一个用于在MCP主机中播放和检查本地音频文件的MCP应用程序。它提供了丰富的音频分析功能，包括全局响度指标（如EBU R128标准下的综合响度LUFS、响度范围LRA等）、瞬时响度指标、基于频谱质心的波形着色、重新分配的频谱图以及循环区域选择。这些特性不仅允许用户直观地查看音频文件的关键属性，还能将当前播放头位置、选定区域等信息反馈给模型，支持后续任务的精准执行。适用于需要对音频进行细致检查与分析的场景，比如音乐制作、音效设计或是任何涉及音频质量评估的工作环境。","2026-06-11 04:05:32","CREATED_QUERY"]