Quick Start

You need Node.js 18+ and API credentials before getting started.

Run this in your terminal: npx songhunt setup

It will ask for your credentials, test them, and automatically configure all your detected IDEs — Claude Code, Cursor, VS Code, Windsurf, JetBrains, and more.

What Can It Do?

• Search for music — Ask for songs in your own words, in any language. For example: "upbeat acoustic guitar for a travel vlog". Returns both popular charting songs and hidden gems to discover.
• Match music to images or videos — Give it a photo, video file, or URL and it will find songs that fit the mood.
• Batch music matching — Point it at a folder of media files and get song recommendations for each one — great for photo albums, video projects, or social media batches.

Text Search

Visual Search

Other IDEs

Add this to .cursor/mcp.json in your project folder (or ~/.cursor/mcp.json for all projects):

{
  "mcpServers": {
    "songhunt": {
      "command": "npx",
      "args": ["-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Replace [email protected] and yourpassword with your actual credentials.

Add this to your VS Code MCP settings JSON:

{
  "servers": {
    "songhunt": {
      "command": "npx",
      "args": ["-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "songhunt": {
      "command": "npx",
      "args": ["-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Add this to your claude_desktop_config.json:

macOS / Linux:

{
  "mcpServers": {
    "songhunt": {
      "command": "npx",
      "args": ["-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "songhunt": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP), click + > As JSON, and paste:

{
  "mcpServers": {
    "songhunt": {
      "command": "npx",
      "args": ["-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Add this to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "songhunt": {
      "command": "npx",
      "args": ["-y", "songhunt"],
      "env": {
        "MYPART_USERNAME": "[email protected]",
        "MYPART_PASSWORD": "yourpassword"
      }
    }
  }
}

Changing Your Credentials

If your email or password changes, run:

npx songhunt login

Uninstalling

To remove Songhunt from all IDEs and delete your saved credentials:

npx songhunt uninstall

CLI Reference

| Command | Description | |---------|-------------| | npx songhunt setup | Set up credentials and configure all detected IDEs | | npx songhunt login | Update saved credentials | | npx songhunt uninstall | Remove Songhunt from all IDEs and delete credentials | | npx songhunt tools | List available MCP tools with usage examples | | npx songhunt status | Show current config, credentials, and environment info | | npx songhunt release-notes | Show what changed in the current version | | npx songhunt check-update | Check if a newer version is available | | npx songhunt help | Show full help with all commands and options |

Aliases: install / i / s for setup, u for uninstall, changelog for release-notes.

Options:

| Flag | Applies to | Description | |------|-----------|-------------| | --dry-run | setup, login, uninstall | Preview what would happen without writing any files | | --emulate-os <platform> | setup, login, uninstall | Emulate OS-specific paths (win32, darwin, linux) | | --all | release-notes | Show the full changelog instead of just the current version |

Supported Media

| Type | Formats | Size Limit | |------|---------|------------| | Images | JPG, PNG, GIF, WEBP, TIFF, SVG | 7 MB (auto-compressed) | | Videos | MP4, MOV, AVI, MKV, WEBM, FLV, WMV | 100 MB |

License

MIT