Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Sfx

FreeNot checked

Sound Effects MCP server — FreeSound API wrapper. CC0 SFX search, download, tag, local cache. 5 operations.

GitHubEmbed

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

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

from github.com/sandraschi/sfx-mcp

Installing Sfx

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sandraschi/sfx-mcp

FAQ

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

Compare Sfx with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All media MCPs