Discogs MCP Server

Discogs MCP-Server

MCP-Server für die Discogs-API, der Musikkatalogvorgänge, Suchfunktionen und mehr ermöglicht.

Schnellstart

Wenn Sie diesen MCP-Server mit der Claude -Desktop-App sofort nutzen möchten und sich nicht um die Entwicklung oder den Betrieb des Servers kümmern möchten, stellen Sie sicher, dass Node.js installiert ist und Ihr persönlicher Discogs-Zugriffstoken bereit ist. Fahren Sie dann direkt mit dem Abschnitt zur Claude-Konfiguration fort. Verwenden Sie die NPX Methode aus diesem Abschnitt.

Inhaltsverzeichnis

• Danksagung
• Verfügbare Tools
• Vorbehalte
• Voraussetzungen
• Aufstellen
• Ausführen des Servers
  • Option 1: Lokale Entwicklung
  • Option 2: Docker
• Inspektion
• MCP-Kunden
  • Claude Desktop-Konfiguration
    • NPX
    • Lokaler Knoten
    • Docker
• ZU TUN
• Lizenz

Danksagung

Dieser MCP-Server basiert auf FastMCP , einem Typescript-Framework zum Erstellen von MCP-Servern. Weitere Informationen zu MCP und zur Verwendung von MCP-Servern finden Sie in der FastMCP-Dokumentation und der offiziellen MCP-Dokumentation .

Verfügbare Tools

Sehen Sie sich die Liste der verfügbaren Tools an: TOOLS.md

Vorbehalte

• Die Discogs-API-Dokumentation ist nicht perfekt und einige Endpunkte sind möglicherweise nicht vollständig dokumentiert oder weisen Inkonsistenzen auf.
• Aufgrund der großen Anzahl von API-Endpunkten und Antworttypen ist es nicht möglich, die Typsicherheit für jede mögliche Antwort zu überprüfen. Bitte melden Sie alle auftretenden typbezogenen Probleme.
• Dieser MCP-Server ermöglicht die Bearbeitung von Daten in Ihrer Discogs-Sammlung. Bitte verwenden Sie ihn mit Vorsicht und überprüfen Sie Ihre Aktionen, bevor Sie sie ausführen.
• Der Discogs-API-Standardwert per_page beträgt 50 . Für manche Clients kann dies zu viele Daten sein, um sie effektiv zu verarbeiten. Daher wurde in diesem Projekt der Wert discogs.config.defaultPerPage auf 5 gesetzt. Sie können in Ihren Eingabeaufforderungen mehr Daten anfordern, beachten Sie jedoch, dass manche Clients mit längeren Antworten möglicherweise Probleme haben.

Voraussetzungen

• Node.js (getestet mit Node.js 20.xx , aber 18.xx sollte auch funktionieren)
  • Überprüfen Sie Ihre Node.js-Version mit: node --version
• Docker (optional, zum Ausführen eines lokalen Docker-Images, ohne sich mit Node oder Abhängigkeiten befassen zu müssen)

Aufstellen

1. Klonen Sie das Repository
2. Erstellen Sie eine .env Datei im Stammverzeichnis basierend auf .env.example
3. Legen Sie die folgenden erforderlichen Umgebungsvariablen in Ihrer .env fest:
   • DISCOGS_PERSONAL_ACCESS_TOKEN : Ihr persönlicher Discogs-Zugriffstoken

Um Ihren persönlichen Discogs-Zugriffstoken zu erhalten, gehen Sie zu Ihren Discogs-Einstellungen > Entwicklerseite und suchen Sie Ihren Token oder generieren Sie einen neuen. Geben Sie Ihren Token nicht weiter . OAuth-Unterstützung wird in einer zukünftigen Version hinzugefügt.

Die anderen Umgebungsvariablen in .env.example sind optional und haben sinnvolle Standardwerte, sodass Sie sie nicht festlegen müssen, es sei denn, Sie haben spezielle Anforderungen.

Lokales Ausführen des Servers

Option 1: Lokale Entwicklung

1. Installieren Sie Abhängigkeiten:
   pnpm install
2. Verfügbare Befehle:
   • pnpm run dev : Starten Sie den Entwicklungsserver mit Hot Reloading
   • pnpm run dev:sse : Starten Sie den Entwicklungsserver mit Hot Reloading im SSE-Modus
   • pnpm run build : Erstellen Sie die Produktionsversion
   • pnpm run start : Führen Sie den Produktionsbuild aus
   • pnpm run inspect : Führen Sie den MCP-Inspektor aus (siehe Abschnitt „Inspektion “)
   • pnpm run format : Codeformatierung prüfen (schöner)
   • pnpm run lint : Linter ausführen (eslint)
   • pnpm run test : Führen Sie vitest aus
   • pnpm run test:coverage : Führen Sie vitest v8 coverage aus
   • pnpm run version:check : Überprüft, ob die Version von package.json und src/version.ts übereinstimmen

Option 2: Docker

1. Erstellen Sie das Docker-Image:
   docker build -t discogs-mcp-server:latest .
2. Führen Sie den Container aus:
   docker run --env-file .env discogs-mcp-server:latest
   Für den SSE-Transportmodus:
   # The port should match what is in your .env file docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest sse

Inspektion

Führen Sie den MCP Inspector aus, um Ihren lokalen MCP-Server zu testen:

Dadurch wird der MCP Inspector unter http://127.0.0.1:6274 gestartet. Rufen Sie diese URL in Ihrem Browser auf, um mit Ihrem lokalen MCP-Server zu interagieren.

Weitere Informationen zum MCP Inspector finden Sie in der offiziellen Dokumentation .

MCP-Kunden

Derzeit wurde dieser MCP-Server nur mit Claude Desktop getestet. Weitere Client-Beispiele werden in Zukunft hinzugefügt.

Claude Desktop-Konfiguration

Suchen Sie Ihre claude_desktop_config.json unter Claude > Settings > Developer > Edit Config und fügen Sie, je nachdem, welche Option Sie möchten, NUR EINES der folgenden Elemente hinzu:

NPX

Führen Sie es direkt aus dem npm-Register aus.

Lokaler Knoten

Bevor Sie diese Methode verwenden ( pnpm install ), sollten die Abhängigkeiten installiert worden sein.

Docker

Das Docker-Image sollte vor der Verwendung dieser Methode erstellt worden sein.

Änderungen am lokalen Code erfordern einen Neustart von Claude, damit sie wirksam werden. Claude erfordert außerdem eine menschliche Interaktion, um die Ausführung eines MCP-Tools zu ermöglichen. Daher fragt Claude bei jedem Zugriff auf ein neues Tool um Erlaubnis. Normalerweise ist dies nur einmal pro Tool und Chat erforderlich. Bei Verwendung der kostenlosen Version können lange Chats häufiger zu Fehlern beim Ausführen von Tools führen, da Claude den Kontext innerhalb eines Chats begrenzt.

ZU TUN

• OAuth-Unterstützung
• Fehlende Werkzeuge:
  • Inventar hochladen

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.