MMAudio

Provides AI-powered audio generation from video or text via MCP-compatible clients.

typescript

3

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mmaudio-mmaudio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mmaudio-mcp@latest"
      ],
      "env": {
        "DEBUG": "false",
        "LOG_LEVEL": "error",
        "MMAUDIO_API_KEY": "sk-your-api-key-here",
        "MMAUDIO_TIMEOUT": "60000",
        "MMAUDIO_BASE_URL": "https://mmaudio.net"
      }
    }
  }
}

MMAudio MCP extends your MCP-compatible client with AI-powered video-to-audio and text-to-audio generation. It lets you validate API keys, generate audio from video or text, and integrates seamlessly with Cursor, Claude Desktop, or any MCP-capable assistant, all through a standardized MCP interface.

How to use

You connect MMAudio MCP to your MCP-compatible client to generate audio from video or text descriptions. Start by ensuring your client is set up to load MCP servers, then add MMAudio as an MCP server. Once connected, you can issue natural language prompts to request audio generations, or validate your API key to verify access and account status. Use the audio tools by describing the video you want converted or the atmosphere you want created, along with optional duration and quality controls.

How to install

# Prerequisites
# - Node.js >= 18.0.0
# - MMAudio API key
# - MCP-compatible client (Cursor, Claude Desktop, etc.)

# 1. Clone or download this extension

cd mcp
npm install

# 2. Configure your API key

# Set environment variable
export MMAUDIO_API_KEY="sk-your-api-key-here"

# Or create a config.js file (copy from config.example.js)
cp config.example.js config.js
# Edit config.js with your API key

# 3. Test the installation

npm start

# 4. Link the package

npm link

Usage with Cursor and Claude Desktop

To use MMAudio MCP with Cursor or Claude Desktop, add MMAudio as a MCP server in your client’s configuration. You provide the command to start the local MMAudio MCP server and the necessary environment variable for your API key. After saving the configuration, restart your client so the MMAudio tools appear in your AI assistant.

Additional notes

You’ll rely on the same API key across sessions, so keep it secure. If you ever need to update your API key, change the MMAUDIO_API_KEY in your environment or config file and restart the MCP client.

Available tools

video_to_audio

Generate AI-powered audio from video content with configurable duration, steps, and guidance strength.

text_to_audio

Create audio from text prompts with controllable duration, steps, and guidance strength.

validate_api_key

Validate the MMAudio API key and check account status.