Discogs MCP server

Discogs MCP Server is a powerful tool that connects to the Discogs API, allowing you to search music catalogs, manage your collection, and perform various music-related operations through compatible clients like Claude and other MCP-enabled applications.

Prerequisites

Before getting started with the Discogs MCP Server, you'll need:

• Node.js (version 18.x.x or 20.x.x recommended)
  • Verify your Node.js version with: node --version
• Docker (optional, for containerized deployment)
• A Discogs personal access token (required)

To obtain your Discogs personal access token, visit your Discogs Settings > Developers page and either find your existing token or generate a new one. Keep this token secure and do not share it.

Installation

Method 1: Using NPX (Easiest)

If you just want to use the server without installing it locally, you can run it directly using NPX:

npx -y discogs-mcp-server

You'll need to provide your Discogs token as an environment variable:

DISCOGS_PERSONAL_ACCESS_TOKEN=your_token_here npx -y discogs-mcp-server

Method 2: Local Installation

To install and run the server locally:

1. Clone the repository:

git clone https://github.com/cswkim/discogs-mcp-server.git
cd discogs-mcp-server

2. Create a .env file in the root directory with your Discogs token:

DISCOGS_PERSONAL_ACCESS_TOKEN=your_token_here

3. Install dependencies:

pnpm install

4. Start the server:

pnpm run dev

For HTTP streaming mode:

pnpm run dev:stream

Method 3: Docker

To run the server in a Docker container:

1. Build the Docker image:

docker build -t discogs-mcp-server:latest .

2. Run the container:

docker run --env DISCOGS_PERSONAL_ACCESS_TOKEN=your_token_here discogs-mcp-server:latest

For HTTP streaming mode:

docker run -p 3001:3001 --env DISCOGS_PERSONAL_ACCESS_TOKEN=your_token_here discogs-mcp-server:latest stream

Client Configuration

Claude Desktop

To use the Discogs MCP Server with Claude Desktop, go to Claude > Settings > Developer > Edit Config and add one of the following configurations:

Using NPX:

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": [
        "-y",
        "discogs-mcp-server"
      ],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Using Local Installation:

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/your/project/folder/src/index.ts"
      ],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Using Docker:

{
  "mcpServers": {
    "discogs": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "DISCOGS_PERSONAL_ACCESS_TOKEN=your_token_here",
        "discogs-mcp-server:latest"
      ]
    }
  }
}

LibreChat

In the librechat.yaml configuration file, add:

mcpServers:
  discogs:
    type: stdio
    command: npx
    args: ["-y", "discogs-mcp-server"]
    env:
      DISCOGS_PERSONAL_ACCESS_TOKEN: your_token_here

LM Studio

In LM Studio's Chat Settings, select "Edit mcp.json" from the Program tab and add:

"discogs": {
  "command": "npx",
  "args": [
    "-y",
    "discogs-mcp-server"
  ],
  "env": {
    "DISCOGS_PERSONAL_ACCESS_TOKEN": "your_token_here"
  }
}

Save the configuration and enable the "mcp/discogs" toggle in the Program tab.

Testing with MCP Inspector

You can test your local MCP server using the MCP Inspector:

pnpm run inspect

This will start the MCP Inspector at http://127.0.0.1:6274. Visit this URL in your browser to interact with and test your local MCP server.

Notes and Limitations

• The default page size for API requests is set to 5 items (the Discogs API default is 50)
• Be cautious when editing your Discogs collection through this server
• Some API endpoints may have inconsistencies due to limitations in the Discogs API documentation
• Type safety is not guaranteed for all possible API responses

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "discogs" '{"command":"npx","args":["-y","discogs-mcp-server"],"env":{"DISCOGS_PERSONAL_ACCESS_TOKEN":"<YOUR_TOKEN>"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "discogs": {
            "command": "npx",
            "args": [
                "-y",
                "discogs-mcp-server"
            ],
            "env": {
                "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "discogs": {
            "command": "npx",
            "args": [
                "-y",
                "discogs-mcp-server"
            ],
            "env": {
                "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect