cswkim/discogs-mcp-server

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

README

53 инструмента

Версии

Установить сервер

License

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.

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

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

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

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер подключает Discogs к AI-ассистентам по протоколу MCP. Он ищет музыку, управляет коллекцией релизов и выдаёт информацию об исполнителях, альбомах и треках — без ручного копирования данных в диалог. Разработчики и коллекционеры используют его, чтобы языковая модель напрямую работала с Discogs API: находить винил, проверять каталоги, редактировать свою библиотеку.

Что он умеет?

Сервер работает с каталогом Discogs: ищет и читает артистов, релизы, лейблы и мастер-релизы, версии мастер-релиза, оценки сообщества и пользовательские рейтинги. Ведёт коллекцию: создаёт и переименовывает папки, добавляет, перемещает и удаляет релизы, ставит оценки, заполняет кастомные поля, считает стоимость коллекции. Управляет вишлистом, маркетплейс-объявлениями, заказами и перепиской по заказам. Запрашивает выгрузку инвентаря в CSV, читает профили, списки пользователей и их правки в базе.

Информация о сервере

Номер в рейтинге: #176
Звезд на Github: 122
Форков на Github: 20
Загрузок: 2 627
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 22:55
Идентификатор: vOrcXxxnQ4Ct5b1t
Категории: Базы данных, Искусство и культура, Исследования и данные, Поиск, Развлечения и медиа