Discogs MCP Server

Servidor MCP de Discogs

Servidor MCP para la API de Discogs, que permite operaciones de catálogo de música, funcionalidad de búsqueda y más.

Inicio rápido

Si solo desea comenzar a usar este servidor MCP de inmediato con la aplicación de escritorio Claude y no le interesa desarrollar ni administrar el servidor usted mismo, asegúrese de tener Node.js instalado y su token de acceso personal de Discogs listo y vaya directamente a la sección de configuración de Claude . Use el método NPX de esa sección.

Tabla de contenido

• Expresiones de gratitud
• Herramientas disponibles
• Advertencias
• Prerrequisitos
• Configuración
• Ejecución del servidor
  • Opción 1: Desarrollo local
  • Opción 2: Docker
• Inspección
• Clientes de MCP
  • Configuración del escritorio de Claude
    • NPX
    • Nodo local
    • Estibador
• HACER
• Licencia

Expresiones de gratitud

Este servidor MCP se creó con FastMCP , un framework de TypeScript para crear servidores MCP. Para más información sobre MCP y cómo usarlos, consulte la documentación de FastMCP y la documentación oficial de MCP .

Herramientas disponibles

Consulte la lista de herramientas disponibles: TOOLS.md

Advertencias

• La documentación de la API de Discogs no es perfecta y es posible que algunos puntos finales no estén completamente documentados o tengan inconsistencias.
• Debido a la gran cantidad de puntos finales de API y tipos de respuesta, no es posible verificar la seguridad de tipos para todas las respuestas posibles. Por favor, informe cualquier problema relacionado con los tipos que encuentre.
• Este servidor MCP permite editar datos de tu colección de Discogs. Úsalo con precaución y verifica tus acciones antes de ejecutarlas.
• El valor predeterminado de la API de Discogs per_page es 50 , lo cual puede representar una cantidad excesiva de datos para que algunos clientes los procesen eficazmente. Por ello, en este proyecto, se ha establecido el valor de discogs.config.defaultPerPage en 5 Puede solicitar más datos en sus solicitudes, pero tenga en cuenta que algunos clientes pueden tener dificultades con respuestas más extensas.

Prerrequisitos

• Node.js (probado con Node.js 20.xx , pero 18.xx también debería funcionar)
  • Comprueba tu versión de Node.js con: node --version
• Docker (opcional, para ejecutar una imagen de Docker local sin tener que lidiar con Node o dependencias)

Configuración

1. Clonar el repositorio
2. Cree un archivo .env en el directorio raíz basado en .env.example
3. Establezca las siguientes variables de entorno obligatorias en su .env :
   • DISCOGS_PERSONAL_ACCESS_TOKEN : Su token de acceso personal de Discogs

Para obtener tu token de acceso personal de Discogs, ve a Configuración > Desarrolladores y busca tu token o genera uno nuevo. NO COMPARTAS TU TOKEN . La compatibilidad con OAuth se añadirá en una próxima versión.

Las demás variables de entorno en .env.example son opcionales y tienen valores predeterminados razonables, por lo que no necesita configurarlas a menos que tenga requisitos específicos.

Ejecución del servidor local

Opción 1: Desarrollo local

1. Instalar dependencias:
   pnpm install
2. Comandos disponibles:
   • pnpm run dev : Inicia el servidor de desarrollo con recarga en caliente
   • pnpm run dev:sse : Inicia el servidor de desarrollo con recarga en caliente en modo SSE
   • pnpm run build : Construye la versión de producción
   • pnpm run start : ejecuta la compilación de producción
   • pnpm run inspect : ejecuta el inspector MCP (consulte la sección Inspección )
   • pnpm run format : Verificar el formato del código (más atractivo)
   • pnpm run lint : Ejecutar linter (eslint)
   • pnpm run test : Ejecutar vitest
   • pnpm run test:coverage : Ejecuta la cobertura de vitest v8
   • pnpm run version:check : Comprueba que la versión de package.json y src/version.ts coincidan

Opción 2: Docker

1. Construya la imagen de Docker:
   docker build -t discogs-mcp-server:latest .
2. Ejecute el contenedor:
   docker run --env-file .env discogs-mcp-server:latest
   Para el modo de transporte SSE:
   # The port should match what is in your .env file docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest sse

Inspección

Ejecute el Inspector MCP para probar su servidor MCP local:

Esto iniciará el Inspector MCP en http://127.0.0.1:6274 . Visite esta URL en su navegador para interactuar con su servidor MCP local.

Para obtener más información sobre MCP Inspector, visita la documentación oficial .

Clientes de MCP

Actualmente, este servidor MCP solo se ha probado con Claude Desktop. Se añadirán más ejemplos de clientes próximamente.

Configuración del escritorio de Claude

Encuentra tu claude_desktop_config.json en Claude > Settings > Developer > Edit Config y, según la opción que desees, agrega SOLO UNA de las siguientes:

NPX

Ejecutándolo directamente desde el registro npm.

Nodo local

Las dependencias deben haberse instalado antes de utilizar este método ( pnpm install ).

Estibador

La imagen de Docker debería haberse creado antes de utilizar este método.

Cualquier cambio en el código local requerirá reiniciar Claude para que surta efecto. Además, Claude requiere interacción humana para ejecutar una herramienta MCP, por lo que cada vez que se acceda a una nueva herramienta, Claude solicitará permiso. Normalmente, solo es necesario hacerlo una vez por herramienta y chat. Si usa la versión gratuita, los chats largos pueden generar errores más frecuentes al intentar ejecutar herramientas, ya que Claude limita la cantidad de contexto dentro de un solo chat.

HACER

• Compatibilidad con OAuth
• Herramientas faltantes:
  • Carga de inventario

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.