Freesound MCP Server

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

Features

The Freesound MCP Server enables AI assistants to:

• Search Audio Content: Find sound effects, ambient sounds, and music loops using natural language queries
• Access Metadata: Get detailed information about audio files including duration, tags, licensing, and descriptions
• Preview Content: Access preview URLs for immediate audio playback evaluation
• License Compliance: Retrieve licensing information to ensure proper attribution and usage rights

Installation

Prerequisites

You will need to obtain a Freesound API key:

1. Create an account at Freesound.org
2. Apply for an API key at https://freesound.org/api/apply/
3. Once approved, note your API key for configuration

Docker Installation (Recommended)

The easiest way to run the Freesound MCP Server is using Docker. No local Python installation required.

Setup

1. Clone the repository:

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

2. Build docker image:

docker build -t freesound-mcp .  

Claude Desktop

Add the following configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Local Installation

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

Requirements

• Python 3.10+
• uv package manager

Setup

1. Clone the repository:

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

2. Install dependencies:

uv sync

3. Set your API key:

export FREESOUND_API_KEY=your_api_key_here

Claude Desktop Configuration

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

Usage

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”