cswkim/discogs-mcp-server

MCP Server for the Discogs API, enabling music catalog operations, search functionality, and more.
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. Use the NPX method from that 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. Please report any type-related issues you encounter.
- This MCP server allows for editing data in your Discogs collection. Please use with caution and verify your actions before executing them.
- The Discogs API per_page default is 50, which can be too much data for some clients to process effectively, so within this project a discogs.config.defaultPerPage value has been set to 5. You can request more data in your prompts, but be aware that some clients may struggle with larger responses.
Prerequisites
- Node.js (tested with Node.js 20.x.x, but 18.x.x should work as well)
- Check your Node.js version with: node --version
- Docker (optional, for running a local docker image without having to deal with Node or dependencies)
Setup
1. Clone the repository
2. Create a .env file in the root directory based on .env.example
3. Set the following required environment variables in your .env:
- DISCOGS_PERSONAL_ACCESS_TOKEN: Your Discogs personal access token
To get your Discogs personal access token, go to your Discogs Settings > Developers page and find your token or generate a new one. **_DO NOT SHARE YOUR TOKEN_**. OAuth support will be added in a future release.
The other environment variables in .env.example are optional and have sensible defaults, so you don't need to set them unless you have specific requirements.
- SERVER_HOST: The host address to bind the server to (default: 0.0.0.0). Set to 0.0.0.0 to allow connections from outside the container/machine, or 127.0.0.1 to restrict to localhost only.
Running the Server Locally
Option 1: Local Development
1. Install dependencies:
2. Available commands:
- pnpm run dev: Start the development server with hot reloading
- pnpm run dev:stream: Start the development server with hot reloading in HTTP streaming mode
- pnpm run build: Build the production version
- pnpm run start: Run the production build