Discogs
Created 5 months ago
MCP Server for the Discogs API, enabling music catalog operations and search functionality.
What is Discogs?
A MCP server that connects to the Discogs API for interacting with your music collection.
Documentation
Quickstart
If you just want to get started immediately using this MCP Server with the Claude desktop app and don't care about development or running the server yourself, then make sure you have Node.js installed and your Discogs personal access token ready and skip straight to the Claude configuration section.
Table of Contents
- Acknowledgements
- Available Tools
- Caveats
- Prerequisites
- Setup
- Running the Server
- Option 1: Local Development
- Option 2: Docker
- Inspection
- MCP Clients
- Claude Desktop Configuration
- NPX
- Local Node
- Docker
- LibreChat
- LM Studio
- TODO
- License
Acknowledgements
This MCP server is built using FastMCP, a typescript framework for building MCP servers. For more information about MCP and how to use MCP servers, please refer to the FastMCP documentation and the official MCP documentation.
Available Tools
Check out the list of available tools: TOOLS.md
Caveats
- The Discogs API documentation is not perfect and some endpoints may not be fully documented or may have inconsistencies.
- Due to the vast number of API endpoints and response types, it's not feasible to verify type safety for every possible response.
- This MCP server allows for editing data in your Discogs collection. Please use with caution and verify your actions before executing them.
Prerequisites
- Node.js (tested with Node.js 20.x.x, but 18.x.x should work as well)
- Docker (optional, for running a local docker image without having to deal with Node or dependencies)
Setup
- Clone the repository
- Create a .env file in the root directory based on .env.example
- Set the required environment variables in your .env:
- DISCOGS_PERSONAL_ACCESS_TOKEN: Your Discogs personal access token
Running the Server Locally# Option 1: Local Development
- Install dependencies: pnpm install
Option 2: Docker
- Build the Docker image: docker build -t discogs-mcp-server:latest .
Inspection
Run the MCP Inspector to test your local MCP server.
MCP Clients
More client examples will be added in the future.
TODO
- OAuth support
- Missing tools: Inventory uploading
License
This MCP server is licensed under the MIT License.
Server Config
{
"mcpServers": {
"discogs-server": {
"command": "npx",
"args": [
"discogs"
]
}
}
}