cswkim/discogs-mcp-server

cswkim/discogs-mcp-server

от cswkim
MCP-сервер для работы с Discogs API: поиск артистов, альбомов, треков и управление личной коллекцией. Полезен коллекционерам винила и разработчикам, интегрирующим музыкальный каталог в AI-ассистент...

License GitHub Release GitHub Actions Workflow Status NPM Downloads Sponsor

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

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

Часто задаваемые вопросы

Инструменты были проиндексированы:
add_release_to_user_collection_folder

Добавляет релиз в папку в коллекции пользователя. folder_id должен быть ненулевым.

Параметры
  • folder_idintegerобязательный
  • release_idnumberобязательный
  • usernamestringобязательный
add_to_wantlist

Добавляет релиз в список желаний пользователя.

Параметры
  • notesstring
  • ratinginteger
  • release_idnumberобязательный
  • usernamestringобязательный
create_marketplace_listing

Создаёт новое объявление в маркетплейсе

Параметры
  • allow_offersboolean
  • commentsstring
  • conditionenumобязательный
  • external_idstring
  • format_quantitynumber
  • locationstring
  • pricenumberобязательный
  • release_idintegerобязательный
  • sleeve_conditionenum
  • statusenumобязательный
  • weightnumber
create_marketplace_order_message

Добавляет новое сообщение в журнал сообщений заказа

Параметры
  • messagestring
  • order_idnumberобязательный
  • statusenum
create_user_collection_folder

Создаёт новую папку в коллекции пользователя.

Параметры
  • namestring
  • usernamestringобязательный
delete_item_in_wantlist

Удаляет релиз из списка желаемых пользователя.

Параметры
  • notesstring
  • ratinginteger
  • release_idnumberобязательный
  • usernamestringобязательный
delete_marketplace_listing

Удаляет объявление на торговой площадке.

Параметры
  • listing_idintegerобязательный
delete_release_from_user_collection_folder

Удаляет экземпляр релиза из папки коллекции пользователя. folder_id должен быть ненулевым.

Параметры
  • folder_idintegerобязательный
  • instance_idintegerобязательный
  • release_idnumberобязательный
  • usernamestringобязательный
delete_release_rating

Удаляет оценку релиза для указанного пользователя

Параметры
  • release_idnumberобязательный
  • usernamestringобязательный
delete_user_collection_folder

Удаляет папку из коллекции пользователя. Папка должна быть пустой, прежде чем её можно удалить.

Параметры
  • folder_idintegerобязательный
  • usernamestringобязательный
download_inventory_export

Скачивает выгрузку инвентаря в формате CSV.

Параметры
  • idnumberобязательный
edit_item_in_wantlist

Редактирует релиз в списке желаемого пользователя.

Параметры
  • notesstring
  • ratinginteger
  • release_idnumberобязательный
  • usernamestringобязательный
edit_marketplace_order

Редактирует заказ на торговой площадке.

Параметры
  • order_idnumberобязательный
  • shippingnumber
  • statusenum
edit_release_rating

Обновляет рейтинг релиза для указанного пользователя

Параметры
  • ratingintegerобязательный
  • release_idnumberобязательный
  • usernamestringобязательный
edit_user_collection_custom_field_value

Редактирует значение пользовательского поля для релиза в коллекции пользователя.

Параметры
  • field_idnumberобязательный
  • folder_idintegerобязательный
  • instance_idnumber | stringобязательный
  • release_idnumber | stringобязательный
  • usernamestringобязательный
  • valuestringобязательный
edit_user_collection_folder

Редактирует метаданные папки. Папки 0 и 1 нельзя переименовать.

Параметры
  • folder_idintegerобязательный
  • namestring
  • usernamestringобязательный
edit_user_profile

Редактирует данные профиля пользователя.

Параметры
  • curr_abbrenum
  • home_pagestring
  • locationstring
  • namestring
  • profilestring
  • usernamestringобязательный
fetch_image

Получает изображение по URL

Параметры
  • urlstringобязательный
find_release_in_user_collection

Находит релиз в коллекции пользователя.

Параметры
  • pageinteger
  • per_pageinteger
  • release_idnumberобязательный
  • sortany
  • sort_orderenum
  • usernamestringобязательный
get_artist

Получает исполнителя

Параметры
  • artist_idnumberобязательный
get_artist_releases

Получает релизы исполнителя

Параметры
  • artist_idnumberобязательный
  • pageinteger
  • per_pageinteger
  • sortenum
  • sort_orderenum
get_inventory_export

Получает детали экспорта инвентаря

Параметры
  • idnumberобязательный
get_inventory_exports

Получает список всех последних экспортов вашего инвентаря.

Параметры

Без параметров.

get_label

Получает метку

Параметры
  • label_idnumberобязательный
get_label_releases

Возвращает список Releases, связанных с label.

Параметры
  • label_idnumberобязательный
  • pageinteger
  • per_pageinteger
  • sortany
  • sort_orderenum
get_list

Получает список по идентификатору

Параметры
  • list_idnumberобязательный
get_marketplace_listing

Получает листинг из маркетплейса

Параметры
  • curr_abbrenum
  • listing_idintegerобязательный
get_marketplace_order

Получает заказ маркетплейса.

Параметры
  • order_idnumberобязательный
get_marketplace_order_messages

Получает список сообщений заказа

Параметры
  • order_idnumberобязательный
  • pageinteger
  • per_pageinteger
  • sortany
  • sort_orderenum
get_marketplace_orders

Получает список заказов маркетплейса.

Параметры
  • archivedboolean
  • created_afterstring
  • created_beforestring
  • pageinteger
  • per_pageinteger
  • sortenum
  • sort_orderenum
  • statusenum
get_marketplace_release_stats

Получает статистику маркетплейса для указанного Release ID

Параметры
  • curr_abbrenum
  • release_idnumberобязательный
get_master_release

Получает мастер-релиз

Параметры
  • master_idintegerобязательный
get_master_release_versions

Получает список всех релизов, которые являются версиями этого master.

Параметры
  • countrystring
  • formatstring
  • labelstring
  • master_idintegerобязательный
  • pageinteger
  • per_pageinteger
  • releasedstring
  • sortenum
  • sort_orderenum
get_release

Получает релиз

Параметры
  • curr_abbrenum
  • release_idnumberобязательный
get_release_community_rating

Получает среднюю оценку сообщества для релиза и количество оценок.

Параметры
  • release_idnumberобязательный
get_release_rating_by_user

Получает рейтинг релиза для указанного пользователя.

Параметры
  • release_idnumberобязательный
  • usernamestringобязательный
get_user_collection_custom_fields

Получает список пользовательских полей заметок коллекции. Эти поля доступны в каждом релизе коллекции.

Параметры
  • usernamestringобязательный
get_user_collection_folder

Возвращает метаданные о папке в коллекции пользователя.

Параметры
  • folder_idintegerобязательный
  • usernamestringобязательный
get_user_collection_folders

Получает список папок в коллекции пользователя.

Параметры
  • usernamestringобязательный
get_user_collection_items

Получает список элементов в коллекции пользователя

Параметры
  • folder_idintegerобязательный
  • pageinteger
  • per_pageinteger
  • sortenum
  • sort_orderenum
  • usernamestringобязательный
get_user_collection_value

Возвращает минимальное, медианное и максимальное значения коллекции пользователя

Параметры
  • usernamestringобязательный
get_user_contributions

Получает вклад пользователя по username.

Параметры
  • pageinteger
  • per_pageinteger
  • sortenum
  • sort_orderenum
  • usernamestringобязательный
get_user_identity

Получает базовую информацию об аутентифицированном пользователе

Параметры

Без параметров.

get_user_inventory

Возвращает список объявлений в инвентаре пользователя.

Параметры
  • pageinteger
  • per_pageinteger
  • sortenum
  • sort_orderenum
  • statusenum
  • usernamestringобязательный
get_user_lists

Получает списки пользователя.

Параметры
  • pageinteger
  • per_pageinteger
  • sortany
  • sort_orderenum
  • usernamestringобязательный
get_user_profile

Получает пользователя по имени пользователя

Параметры
  • usernamestringобязательный
get_user_submissions

Получает публикации пользователя по имени пользователя.

Параметры
  • usernamestringобязательный
get_user_wantlist

Возвращает список релизов в wantlist пользователя.

Параметры
  • pageinteger
  • per_pageinteger
  • sortenum
  • sort_orderenum
  • usernamestringобязательный
inventory_export

Запросите экспорт вашего инвентаря в CSV.

Параметры

Без параметров.

move_release_in_user_collection

Перемещает релиз в коллекции пользователя в другую папку.

Параметры
  • destination_folder_idnumberобязательный
  • folder_idintegerобязательный
  • instance_idintegerобязательный
  • release_idnumberобязательный
  • usernamestringобязательный
rate_release_in_user_collection

Оценивает релиз в коллекции пользователя. Параметр folder_id должен быть ненулевым.

Параметры
  • folder_idintegerобязательный
  • instance_idintegerобязательный
  • ratinginteger
  • release_idnumberобязательный
  • usernamestringобязательный
search

Отправляет поисковый запрос в базу данных Discogs

Параметры
  • anvstring
  • artiststring
  • barcodestring
  • catnostring
  • contributorstring
  • countrystring
  • creditstring
  • formatstring
  • genrestring
  • labelstring
  • pageinteger
  • per_pageinteger
  • qstring
  • release_titlestring
  • sortenum
  • sort_orderenum
  • stylestring
  • submitterstring
  • titlestring
  • trackstring
  • typeenum
  • yearstring
update_marketplace_listing

Обновляет объявление в маркетплейсе

Параметры
  • allow_offersboolean
  • commentsstring
  • conditionenumобязательный
  • external_idstring
  • format_quantitynumber
  • listing_idintegerобязательный
  • locationstring
  • pricenumberобязательный
  • release_idintegerобязательный
  • sleeve_conditionenum
  • statusenumобязательный
  • weightnumber
0.5.7основная
0.5.6
0.5.5
0.5.4
0.5.3
0.5.2
0.5.1
0.5.0
0.4.3
0.4.2
0.4.1
0.4.0
0.3.0
0.2.0
0.1.0

Выберите клиент, чтобы установить cswkim/discogs-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "cswkim-discogs-mcp-server-56egvmmjde": {
      "type": "stdio",
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      },
      "args": [
        "-y",
        "discogs-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"cswkim-discogs-mcp-server-56egvmmjde\",\"type\":\"stdio\",\"env\":{\"DISCOGS_PERSONAL_ACCESS_TOKEN\":\"<YOUR_TOKEN>\"},\"args\":[\"-y\",\"discogs-mcp-server\"],\"command\":\"npx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

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

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "cswkim-discogs-mcp-server-56egvmmjde": {
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      },
      "args": [
        "-y",
        "discogs-mcp-server"
      ],
      "command": "npx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add cswkim-discogs-mcp-server-56egvmmjde --env DISCOGS_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> -- npx -y discogs-mcp-server

Либо через JSON-конфиг:

claude mcp add-json cswkim-discogs-mcp-server-56egvmmjde "{\"env\":{\"DISCOGS_PERSONAL_ACCESS_TOKEN\":\"<YOUR_TOKEN>\"},\"args\":[\"-y\",\"discogs-mcp-server\"],\"command\":\"npx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add cswkim-discogs-mcp-server-56egvmmjde --env DISCOGS_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> -- npx -y discogs-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.cswkim-discogs-mcp-server-56egvmmjde]
command = "npx"
args = ["-y", "discogs-mcp-server"]

[mcp_servers.cswkim-discogs-mcp-server-56egvmmjde.env]
DISCOGS_PERSONAL_ACCESS_TOKEN = "<YOUR_TOKEN>"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите cswkim/discogs-mcp-server, а в поле команды запуска — строку ниже:
npx -y discogs-mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "cswkim-discogs-mcp-server-56egvmmjde": {
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      },
      "args": [
        "-y",
        "discogs-mcp-server"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например cswkim-discogs-mcp-server-56egvmmjde.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: cswkim-discogs-mcp-server-56egvmmjde
    command: npx
    args:
      - "-y"
      - "discogs-mcp-server"
    env:
      DISCOGS_PERSONAL_ACCESS_TOKEN: <YOUR_TOKEN>
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

clanker-records/crompton-network

clanker-records/crompton-network

от clanker-records

MCP-сервер для нативного прослушивания альбома *Straight Outta Crompton* от машинных артистов C.W.A. Агенты получают доступ к потоковой передаче треков, покадровой аналитике (спектрограммы, метрики...

JavaScript⭐ 2
gregario/lego-oracle

gregario/lego-oracle

от gregario

MCP сервер для поиска наборов, деталей и минифигурок LEGO. AI-ассистенты получают достоверные данные из каталога Rebrickable — 26 тысяч наборов, 62 тысячи деталей. Работает офлайн, без галлюцинаций. Полезен коллекционерам и разработчикам.

TypeScript⭐ 4
austenstone/myinstants-mcp

austenstone/myinstants-mcp

от austenstone

MCP-сервер, подключающий AI-агента к звуковой панели myinstants.com с миллионами звуков — мемов, игровых sfx, реакций. Позволяет искать, воспроизводить через динамики, просматривать категории и тренды. Полезен разработчикам, чтобы добавить агенту звуковые эффекты (вин-бум, сад-тромбон) и сделать ...

JavaScript⭐ 19
Cifero74/mcp-apple-music

Cifero74/mcp-apple-music

от cifero74

MCP-сервер для Claude, дающий полный доступ к Apple Music: поиск по каталогу, управление плейлистами и библиотекой, персональные рекомендации на основе истории прослушивания. Простая настройка чере...

Python⭐ 44
jhomen368/overseerr-mcp

jhomen368/overseerr-mcp

от jhomen368

MCP-сервер для интеграции AI-ассистентов с Seerr/Overseerr: поиск, запрос и управление медиа. Полезен владельцам медиа-серверов для автоматизации запросов фильмов и сериалов через ИИ.

TypeScript⭐ 25
Alisammour/storyflo-mcp

Alisammour/storyflo-mcp

от alisammour

MCP сервер Storyflo даёт LLM-агентам доступ к аудио-новостям: поиск статей по темам, получение текста и аудио, подписка на ленты. Полезен разработчикам для интеграции озвученного контента в ИИ-ассистенты.

JavaScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин