Sfx
БесплатноНе проверенSound Effects MCP server — FreeSound API wrapper. CC0 SFX search, download, tag, local cache. 5 operations.
Описание
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
Установка Sfx
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/sandraschi/sfx-mcpFAQ
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
ARA
Generate images, video and audio from any AI agent — one connector.
автор: 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/
автор: buildwithtazaYouTube
Transcripts, channel stats, search
автор: YouTubeEverArt
AI image generation using various models.
автор: 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.
автор: gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
автор: merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
автор: SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
автор: YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
автор: AceDataCloudAceDataCloud/MCPNanoBanana
Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.
автор: AceDataCloudCompare Sfx with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории media
