Sfx
FreeNot checkedSound Effects MCP server — FreeSound API wrapper. CC0 SFX search, download, tag, local cache. 5 operations.
About
Sound Effects MCP server — FreeSound API wrapper. CC0 SFX search, download, tag, local cache. 5 operations.
README
FastMCP 3.4+ server wrapping the FreeSound API for CC0-licensed sound effects search and download.
Prerequisites
- Python 3.12+
- uv
- FreeSound API key (apply here)
Setup
# Clone and enter directory
cd sfx-mcp
# Create .env with your API key
cp .env.example .env
# Edit .env: set FREESOUND_API_KEY=your_key
# Install dependencies
uv sync
# Run in stdio mode (for Claude Desktop, Cursor, etc.)
uv run python -m sfx_mcp
# Or run in HTTP mode (for webapp integration)
uv run python run_server.py
# Listens on http://127.0.0.1:11120
# MCP streamable-HTTP endpoint: http://127.0.0.1:11120/mcp (both spellings work;
# a path-alias middleware avoids the Mount 405; REST stays on /api/*)
# Transports: stdio (default) | --serve | --stdio | --port N | MCP_PORT=N
# Health check: http://127.0.0.1:11120/api/health
Claude Desktop Config
{
"mcpServers": {
"sfx": {
"command": "uv",
"args": ["run", "--directory", "D:\\Dev\\repos\\sfx-mcp", "python", "-m", "sfx_mcp"]
}
}
}
Tools
sfx_search (portmanteau)
| Operation | Description |
|---|---|
search |
Query FreeSound for CC0 sounds. Filters: query, duration_max, tags, page. |
download |
Download a sound by ID to local disk. |
tag |
Assign a user tag to a cached sound (local SQLite). |
list_local |
List all locally cached sounds, optionally filtered by tag. |
describe |
Get full metadata for a sound (name, duration, samplerate, tags, preview URL). |
play |
Play a locally cached sound file using the system default player or winsound (Windows). |
show_sfx_browser_card
Prefab rich card showing all locally cached sounds with names, durations, and paths.
Ports
| Service | Port |
|---|---|
| Backend (HTTP/MCP) | 11120 |
| Frontend (Vite dev) | 11121 |
Webapp
webapp/frontend/ (React + Tailwind, bun run dev on 11121, proxies /api to
11120; bun run build outputs to webapp/frontend/dist/, served by the backend
with SPA fallback). Pages: Dashboard, Sounds (search + preview + cache), Library
(local sounds, tag filter), Tools (live MCP inventory), Logs (standard ring
buffer page), Settings, Help.
Log buffer: ring buffer (SFX_LOG_MAX_ENTRIES, default 2000) behind
GET /api/logs (+ /stats, /export, DELETE /api/logs). Tool calls log as
kind: tool_call via FastMCP middleware — no per-tool edits.
License
MIT
Installing Sfx
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/sfx-mcpFAQ
Is Sfx MCP free?
Yes, Sfx MCP is free — one-click install via Unyly at no cost.
Does Sfx need an API key?
No, Sfx runs without API keys or environment variables.
Is Sfx hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Sfx in Claude Desktop, Claude Code or Cursor?
Open Sfx on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
ARA
Generate images, video and audio from any AI agent — one connector.
by ARAOmni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
by buildwithtazaYouTube
Transcripts, channel stats, search
by YouTubeEverArt
AI image generation using various models.
by modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
by gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
by merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
by SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
by YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
by AceDataCloudAceDataCloud/MCPNanoBanana
Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.
by AceDataCloudCompare Sfx with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All media MCPs
