Сервер MCP Discogs

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

Быстрый старт

Если вы просто хотите немедленно начать использовать этот MCP Server с приложением Claude для рабочего стола и не заботитесь о разработке или запуске сервера самостоятельно, то убедитесь, что у вас установлен Node.js и готов ваш личный токен доступа Discogs, и перейдите сразу к разделу конфигурации Claude . Используйте метод NPX из этого раздела.

Оглавление

• Благодарности

• Доступные инструменты

• Предостережения

• Предпосылки

• Настраивать

• Запуск сервера

  • Вариант 1: Местное развитие

  • Вариант 2: Докер

• Инспекция

• Клиенты МКП

  • Конфигурация рабочего стола Клода

    • НПХ

    • Локальный узел

    • Докер

• ДЕЛО

• Лицензия

Благодарности

Этот сервер MCP создан с использованием FastMCP , фреймворка TypeScript для создания серверов MCP. Для получения дополнительной информации о MCP и о том, как использовать серверы MCP, обратитесь к документации FastMCP и официальной документации MCP .

Доступные инструменты

Ознакомьтесь со списком доступных инструментов: TOOLS.md

Предостережения

• Документация API Discogs не идеальна, и некоторые конечные точки могут быть не полностью документированы или иметь несоответствия.

• Из-за огромного количества конечных точек API и типов ответов невозможно проверить безопасность типов для каждого возможного ответа. Пожалуйста, сообщайте о любых проблемах, связанных с типами, с которыми вы сталкиваетесь.

• Этот сервер MCP позволяет редактировать данные в вашей коллекции Discogs. Пожалуйста, используйте его с осторожностью и проверяйте свои действия перед их выполнением.

• Значение по умолчанию для Discogs API per_page равно 50 , что может оказаться слишком большим объемом данных для эффективной обработки некоторыми клиентами, поэтому в этом проекте значение discogs.config.defaultPerPage установлено равным 5 Вы можете запросить больше данных в своих запросах, но учтите, что некоторые клиенты могут испытывать трудности с большими ответами.

Предпосылки

• Node.js (протестировано с Node.js 20.xx , но 18.xx тоже должен работать)

  • Проверьте версию Node.js с помощью: node --version

• Docker (опционально, для запуска локального образа Docker без необходимости иметь дело с Node или зависимостями)

Настраивать

1. Клонировать репозиторий

2. Создайте файл .env в корневом каталоге на основе .env.example

3. Установите следующие обязательные переменные среды в вашем .env :

   • DISCOGS_PERSONAL_ACCESS_TOKEN : Ваш персональный токен доступа Discogs

Чтобы получить свой личный токен доступа Discogs, перейдите на страницу настроек Discogs > Разработчики и найдите свой токен или сгенерируйте новый. НЕ ДЕЛИТЕСЬ СВОИМ ТОКЕНОМ . Поддержка OAuth будет добавлена в будущем выпуске.

Другие переменные среды в .env.example являются необязательными и имеют разумные значения по умолчанию, поэтому вам не нужно их устанавливать, если у вас нет особых требований.

Локальный запуск сервера

Вариант 1: Местное развитие

1. Установите зависимости:

   pnpm install

2. Доступные команды:

   • pnpm run dev : запуск сервера разработки с горячей перезагрузкой

   • pnpm run dev:sse : Запуск сервера разработки с горячей перезагрузкой в режиме SSE

   • pnpm run build : сборка рабочей версии

   • pnpm run start : Запуск производственной сборки

   • pnpm run inspect : Запуск MCP Inspector (см. раздел «Инспекция» )

   • pnpm run format : проверка форматирования кода (красивее)

   • pnpm run lint : Запустить линтер (eslint)

   • pnpm run test : Запустить vitest

   • pnpm run test:coverage : Запустить vitest v8 coverage

   • pnpm run version:check : проверяет, что версии package.json и src/version.ts совпадают

Вариант 2: Докер

1. Создайте образ Docker:

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

2. Запустите контейнер:

   docker run --env-file .env discogs-mcp-server:latest

   Для транспортного режима SSE:

   # The port should match what is in your .env file docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest sse

Инспекция

Запустите MCP Inspector для проверки локального сервера MCP:

Это запустит MCP Inspector по адресу http://127.0.0.1:6274 . Перейдите по этому URL в своем браузере, чтобы взаимодействовать с локальным сервером MCP.

Более подробную информацию о MCP Inspector можно найти в официальной документации .

Клиенты МКП

В настоящее время этот сервер MCP был протестирован только с Claude Desktop. В будущем будут добавлены дополнительные примеры клиентов.

Конфигурация рабочего стола Клода

Найдите файл claude_desktop_config.json в разделе Claude > Settings > Developer > Edit Config и в зависимости от того, какой параметр вам нужен, добавьте ТОЛЬКО ОДИН из следующих:

НПХ

Запускаем его прямо из реестра npm.

Локальный узел

Перед использованием этого метода необходимо установить зависимости ( pnpm install ).

Докер

Перед использованием этого метода необходимо создать образ Docker.

Любые изменения в локальном коде потребуют перезапуска Claude для вступления в силу. Кроме того, Claude требует взаимодействия с человеком для запуска инструмента MCP, поэтому каждый раз при доступе к новому инструменту Claude будет запрашивать разрешение. Обычно вам нужно сделать это только один раз для инструмента в чате. При использовании бесплатной версии длинные чаты могут привести к более частым ошибкам при попытке запустить инструменты, поскольку Claude ограничивает объем контекста в пределах одного чата.

ДЕЛО

• Поддержка OAuth

• Отсутствующие инструменты:

  • Загрузка инвентаря

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.