freesound-mcp
About
A Model Context Protocol (MCP) server that enables AI applications to search and download audio resources from the Freesound platform via natural language commands.
Details
- Author
- mushan-bit
- Categories
- Web Scraping, Other, Media, Search
Jump to
Setup
Install freesound-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/mushan-bit/freesound-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server that enables AI applications to search and download audio resources from theFreesoundplatform via natural language commands.
Freesound-MCP is designed to simplify the integration of copyright-free sound resources into AI tools. It follows the Model Context Protocol standard and communicates with host applications via stdin/stdout. The server provides two main capabilities:
- 🔍Search Sounds: Search for sounds by keywords with optional filters for maximum duration and license type
- ⬇️Download Sounds: Download audio files by sound ID from Freesound
- 🎵Metadata Support: Retrieve detailed information about sounds, including duration, license, and preview links
- Lightweight MCP server built with Node.js
- Standard input/output communication mechanism compliant with MCP protocol
- Secure API key management through environment variables
- No database required - simple, stateless design
- Node.js (supports CommonJS modules)
- npm or yarn package manager
- A Freesound API key (get one atFreesound API page)
git clone https://github.com/yourusername/freesound-mcp.git cd freesound-mcp
-
Get your Freesound API key fromFreesound API page
Set your API key as an environment variable:
export FREESOUND_API_KEY=your_freesound_api_key_here
To configure this MCP server in Claude Desktop:
- Open Claude Desktop preferences
- Navigate to "Beta Features" → "Model Context Protocol (MCP) Tools"
- Click "Configure" to manage MCP servers
- Add a new server configuration with these details:
- Name: "Freesound MCP"
- Command:node
- Arguments:/path/to/freesound-mcp/dist/index.js(after runningnpm run build)
- Environment Variables: EnsureFREESOUND_API_KEYis available to the process
After restarting Claude, you'll be able to use the Freesound tools in your conversations.
Once configured in Claude, you can use natural language commands such as:
- "Find me a rainforest ambient sound under 30 seconds"
- "Download sound #123456 as high quality"
1. Freesound Search (freesound_search)
Search for sounds on Freesound by providing keywords and optional filters.
- query(required): Search keywords
- maxDuration(optional): Maximum duration of sounds in seconds
- license(optional): License type of sounds to search for
- Array of sound objects containing:
- id: Sound ID
- name: Sound name
- duration: Sound duration in seconds
- license: Sound license
- preview: Sound preview URL
2. Freesound Download (freesound_download)
Download a sound from Freesound by sound ID.
- soundId(required): ID of the sound to download
- quality(optional): Audio quality ('hq' for high quality or 'lq' for low quality), defaults to 'lq'
- downloadDir(optional): Custom download directory, defaults to ~/.freesound-mcp/downloads
- filePath: Path where the file was downloaded
- Keep yourFREESOUND_API_KEYsecret and never expose it in client-side code
- Input parameters are validated to prevent malicious IDs from being passed to the API
- The server follows MCP security best practices for communication
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the MIT License - see theLICENSEfile for details.
- Thanks toFreesoundfor providing the audio resources API
- Built using theModel Context Protocol SDK
MCP server for Al Jazeera 360 — Connect AI assistants to Al Jazeera's streaming catalog. Search, browse, and retrieve Arabic video content with direct watch links.
Interact with the Bilibili video website, enabling actions like searching for videos, retrieving video information, and accessing user data.
Download video and audio content from various websites like YouTube, Facebook, and Tiktok using yt-dlp.
Download video and audio from various platforms like YouTube, Facebook, and TikTok using yt-dlp.
Add audio search to via MCP - Search any audio in seconds
Search and discover audio content from Freesound.org for video editing and content creation.
Search, download, and extract information from YouTube music videos.
A soundboard MCP server with millions of meme sounds from myinstants.com — search, play, and browse categories. npx myinstants-mcp to get started.
一个基于 Model Context Protocol (MCP) 构建的智能电影和电视剧资源搜索工具,支持多源搜索和链接验证。An intelligent movie and TV series resource search tool based on Model Context Protocol (MCP), supporting multi-source search and link verification.
Search a real music catalogue from your assistant, get 30-second previews you can play, and add songs straight to your Apple Music playlists.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




