aimp-mcp-server

Steuert den AIMP Music Player über das Model Context Protocol (MCP). Funktioniert mit Claude Desktop und LM Studio.

---

1. https://www.python.org/downloads/ → Python 3.11+, Haken bei „Add Python to PATH"
2. In einer cmd.exe:

   pip install mcp pyaimp pywin32 mutagen

> mutagen ist optional — ohne es funktioniert alles außer Jahr- und Genre-Suche.

---

Kopiere server.py in einen festen Ordner, z.B.:

C:\Users\DEIN_NAME\aimp_mcp\server.py

---

Alle Pfade werden direkt im MCP-JSON-Eintrag hinterlegt — kein Anfassen der server.py nötig. Das macht es einfach mehrere Rechner mit unterschiedlichen Pfaden zu betreiben.

Datei öffnen: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aimp": {
      "command": "python",
      "args": ["C:\\Users\\DEIN_NAME\\aimp_mcp\\server.py"],
      "env": {
        "AIMP_EXE":          "C:\\Program Files\\AIMP\\AIMP.exe",
        "AIMP_MUSIC_DIRS":   "D:\\DEIN_PFAD\Musik",
        "AIMP_PLAYLIST_DIR": "D:\\DEIN_PFAD\\Musik\\Playlisten",
        "AIMP_ADB_PATH":     "C:\\Users\\DEIN_NAME\\AppData\\Roaming\\AIMP\\AudioLibrary\\Local.adb"
      }
    }
  }
}

Mehrere Musikordner → mit Semikolon trennen:

"AIMP_MUSIC_DIRS": "D:\\Musik;E:\\Mehr Musik;F:\\Archiv"

Einstellungen → MCP Servers → Add Server → stdio:

{
  "command": "python",
  "args": ["C:\\Users\\DEIN_NAME\\aimp_mcp\\server.py"],
  "env": {
    "AIMP_EXE":          "C:\\Program Files\\AIMP\\AIMP.exe",
    "AIMP_MUSIC_DIRS":   "D:\\DEIN_PFAD\\Musik",
    "AIMP_PLAYLIST_DIR": "D:\\DEIN_PFAD\\Musik\\Playlisten"
  }
}

---

| Tool | Beispiel-Prompt | |---|---| | aimp_get_status | „Was spielt gerade?" | | aimp_play/pause/stop | „Pause", „Play", „Stop" | | `aim