Freesound MCP Server

Search and discover audio content from Freesound.org for video editing and content creation.

A Model Context Protocol (MCP) server that integrates withFreesound.org, enabling AI agents to search and discover audio content for video editing and content creation workflows.

You will need to obtain a Freesound API key:
- Create an account atFreesound.org
- Apply for an API key athttps://freesound.org/api/apply/
- Once approved, note your API key for configuration

git clone https://github.com/johnkimdw/freesound-mcp-server.git cd freesound-mcp-server

{ "mcpServers": { "freesound": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "FREESOUND_API_KEY", "freesound-mcp" ], "env": { "FREESOUND_API_KEY": "<YOUR_FREESOUND_API_KEY>" } } } }

If you prefer not to use Docker, you can install and run the server locally using Python and uv.

git clone https://github.com/johnkimdw/freesound-mcp-server.git cd freesound-mcp-server

export FREESOUND_API_KEY=your_api_key_here

{ "mcpServers": { "freesound": { "command": "/path/to/uv", "args": [ "--directory", "/path/to/freesound-mcp-server", "run", "freesound-mcp" ], "env": { "FREESOUND_API_KEY": "<YOUR_FREESOUND_API_KEY>" } } } }

Once configured, you can interact with the Freesound MCP Server through your AI assistant. Here are some example queries:

- "Find thunder sound effects for a storm scene"
- "Search for ambient city sounds under 30 seconds"
- "Look for piano music loops with Creative Commons licensing"
- "Find dog barking sound effects"
- "Search for ocean waves background audio"

Search for audio files on Freesound.org using natural language queries.

- query(string, required): Search terms for audio content
- max_results(integer, optional): Number of results to return (1-30, default: 10)

- Audio file metadata including:

- File name and description
- Duration and file format
- Tags and categories
- License information
- Preview URLs (high and low quality)
- Uploader information
- Direct links to Freesound.org pages

The server supports multiple transport methods for different deployment scenarios:

Used for local integration with Claude Desktop and other MCP clients:

uv run freesound-mcp # python -m freesound_mcp.server --transport stdio

# Clone the repository git clone https://github.com/yourname/freesound-mcp-server.git cd freesound-mcp-server # Install dependencies uv sync # Run tests uv run pytest # Build Docker image docker build -t freesound-mcp .

Use the MCP Inspector for detailed debugging:

npx @modelcontextprotocol/inspector uv run freesound-mcp

This MCP server respects Freesound.org's terms of service and API usage guidelines. All audio content retrieved through this server:

- Originates from Freesound.org and is subject to their licensing terms
- Requires proper attribution as specified by individual file licenses
- Should be used in compliance with Creative Commons and other applicable licenses

Important: Always review the licensing information provided with each audio file to ensure compliance with attribution requirements and usage restrictions.

The server includes comprehensive error handling for common scenarios:

- Invalid API Key: Clear error messages when authentication fails
- Rate Limiting: Automatic handling of API rate limits with appropriate error responses
- Network Issues: Timeout handling and connection error management
- Invalid Queries: Input validation and sanitization

- FREESOUND_API_KEY(required): Your Freesound.org API key

For advanced users, additional configuration options are available through command-line arguments:

This project is licensed under the MIT License - see theLICENSEfile for details.

Create and publish unlimited podcast shows and episodes with ELEMENT.FM