Freesound MCP Server
An MCP (Model Context Protocol) server that provides access to the Freesound API, enabling AI assistants to search, analyze, and retrieve information about audio samples from Freesound.org.
Prerequisites
- Node.js 16 or higher
- A Freesound API key (get one at https://freesound.org/apiv2/apply)
Installation
- Clone this repository:
- Install dependencies:
- Build the project:
Quick Start with Claude Code
Global Installation (All Projects)
- Get your Freesound API key from https://freesound.org/apiv2/apply
- Add to Claude Code:
Verifying Installation
To check if the MCP server is properly configured and running, use the /mcp
command in Claude Code:
This will show the status of all configured MCP servers.
Usage with Claude Desktop
Add the following to your Claude Desktop configuration file:
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\claude_desktop_config.json
Available Tools
search_sounds
Search for sounds on Freesound using text queries.
Parameters:
query
(required): Search query termsfilter
: Filter using Solr syntax (e.g., "duration")sort
: Sort results by various criteriapage
: Page number (default: 1)page_size
: Results per page (default: 15, max: 150)
Example:
get_sound
Get detailed information about a specific sound.
Parameters:
sound_id
(required): The ID of the sounddescriptors
: Comma-separated list of content descriptors to include
get_sound_analysis
Retrieve audio analysis data for a sound.
Parameters:
sound_id
(required): The ID of the sounddescriptors
: Specific analysis descriptors to retrievenormalized
: Whether to normalize descriptor values
get_similar_sounds
Find sounds similar to a given sound.
Parameters:
sound_id
(required): The ID of the reference sounddescriptors_filter
: Filter by content descriptorspage
: Page numberpage_size
: Results per page
get_user
Get information about a Freesound user.
Parameters:
username
(required): The username
get_user_sounds
Get sounds uploaded by a specific user.
Parameters:
username
(required): The usernamepage
: Page numberpage_size
: Results per page
get_pack
Get information about a sound pack.
Parameters:
pack_id
(required): The ID of the pack
get_pack_sounds
Get sounds from a specific pack.
Parameters:
pack_id
(required): The ID of the packpage
: Page numberpage_size
: Results per page
Development
Run the server in development mode:
API Limitations
- Token authentication is used for most endpoints
- OAuth2 is required for downloading sounds and write operations (not implemented in this version)
- Rate limits apply based on your Freesound API plan
- Maximum page size is 150 results
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support
For issues with the Freesound API, consult:
- Freesound API Documentation: https://freesound.org/docs/api/
- Freesound API Forum: https://freesound.org/forum/
For issues with this MCP server, please open an issue on GitHub.
This server cannot be installed
An MCP server that enables AI assistants to search, analyze, and retrieve information about audio samples from Freesound.org through their API.
Related MCP Servers
- -securityFlicense-qualityMCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.Last updated -
- AsecurityAlicenseAqualityA MCP server that enables transcription of audio files using OpenAI's Speech-to-Text API, with support for multiple languages and file saving options.Last updated -12JavaScriptMIT License
- -securityFlicense-qualityAn MCP server that downloads videos/extracts audio from various platforms like YouTube, Bilibili, and TikTok, then transcribes them to text using OpenAI's Whisper model.Last updated -2Python
- AsecurityFlicenseAqualityAn MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment retrieval, and more.Last updated -812Python