Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Sfx

БесплатноНе проверен

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

GitHubEmbed

Описание

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

Установка Sfx

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/sandraschi/sfx-mcp

FAQ

Sfx MCP бесплатный?

Да, Sfx MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Sfx?

Нет, Sfx работает без API-ключей и переменных окружения.

Sfx — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Sfx в Claude Desktop, Claude Code или Cursor?

Открой Sfx на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Sfx with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории media