Discogs MCP 서버

Discogs API를 위한 MCP 서버로, 음악 카탈로그 작업, 검색 기능 등을 제공합니다.

빠른 시작

Claude 데스크톱 앱에서 이 MCP 서버를 바로 사용하고 싶고 개발이나 서버 직접 운영에 관심이 없다면 Node.js가 설치되어 있고 Discogs 개인 액세스 토큰이 준비되었는지 확인하고 바로 Claude 구성 섹션 으로 이동하세요. 해당 섹션의 NPX 메서드를 사용하세요.

감사의 말

이 MCP 서버는 MCP 서버 구축을 위한 타입스크립트 프레임워크인 FastMCP를 사용하여 구축되었습니다. MCP 및 MCP 서버 사용 방법에 대한 자세한 내용은 FastMCP 설명서 와 공식 MCP 설명서를 참조하세요.

사용 가능한 도구

사용 가능한 도구 목록을 확인하세요: TOOLS.md

주의사항

Discogs API 문서는 완벽하지 않으며 일부 엔드포인트는 완전히 문서화되지 않았거나 일관성이 없을 수 있습니다.
API 엔드포인트와 응답 유형이 매우 다양하기 때문에 가능한 모든 응답에 대해 유형 안전성을 검증하는 것은 불가능합니다. 유형 관련 문제가 발생하면 알려주세요.
이 MCP 서버를 사용하면 Discogs 컬렉션의 데이터를 편집할 수 있습니다. 주의해서 사용하고 실행하기 전에 작업을 확인하세요.
Discogs API의 per_page 기본값은 50 , 일부 클라이언트가 효과적으로 처리하기에는 너무 많은 데이터가 될 수 있습니다. 따라서 이 프로젝트에서는 discogs.config.defaultPerPage 값을 5 로 설정했습니다. 프롬프트에서 더 많은 데이터를 요청할 수 있지만, 일부 클라이언트는 더 큰 응답을 처리하는 데 어려움을 겪을 수 있습니다.

필수 조건

Node.js(Node.js 20.xx 로 테스트했지만 18.xx 에서도 작동해야 함)
- node --version 사용하여 Node.js 버전을 확인하세요.
Docker(선택 사항, Node나 종속성을 처리하지 않고 로컬 Docker 이미지를 실행하기 위한 것)

설정

저장소를 복제합니다
.env.example 기반으로 루트 디렉토리에 .env 파일을 만듭니다.
.env 에 다음의 필수 환경 변수를 설정하세요:
- DISCOGS_PERSONAL_ACCESS_TOKEN : Discogs 개인 액세스 토큰

Discogs 개인 액세스 토큰을 받으려면 Discogs 설정 > 개발자 페이지로 이동하여 토큰을 찾거나 새 토큰을 생성하세요. 토큰을 공유하지 마세요 . OAuth 지원은 향후 릴리스에서 추가될 예정입니다.

.env.example 의 다른 환경 변수는 선택 사항이며 합리적인 기본값을 가지고 있으므로 특정 요구 사항이 없는 한 설정할 필요가 없습니다.

로컬에서 서버 실행

옵션 1: 지역 개발

종속성 설치:지엑스피1
사용 가능한 명령:
- pnpm run dev : 핫 리로딩으로 개발 서버 시작
- pnpm run dev:sse : SSE 모드에서 핫 리로딩으로 개발 서버를 시작합니다.
- pnpm run build : 프로덕션 버전 빌드
- pnpm run start : 프로덕션 빌드를 실행합니다.
- pnpm run inspect : MCP 검사기를 실행합니다( 검사 섹션 참조)
- pnpm run format : 코드 형식 확인(더 보기 좋게)
- pnpm run lint : linter 실행(eslint)
- pnpm run test : vitest 실행
- pnpm run test:coverage : vitest v8 coverage를 실행합니다.
- pnpm run version:check : package.json 버전과 src/version.ts가 일치하는지 확인합니다.

옵션 2: Docker

Docker 이미지를 빌드합니다.
docker build -t discogs-mcp-server:latest .
컨테이너를 실행합니다.
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 검사기를 실행하여 로컬 MCP 서버를 테스트하세요.

pnpm run inspect

그러면 http://127.0.0.1:6274 에서 MCP Inspector가 시작됩니다. 브라우저에서 이 URL을 방문하여 로컬 MCP 서버와 상호 작용하세요.

MCP Inspector에 대한 자세한 내용은 공식 문서를 참조하세요.

MCP 클라이언트

현재 이 MCP 서버는 Claude Desktop에서만 테스트되었습니다. 향후 더 많은 클라이언트 예제가 추가될 예정입니다.

클로드 데스크톱 구성

Claude > Settings > Developer > Edit Config 에서 claude_desktop_config.json 을 찾은 후, 원하는 옵션에 따라 다음 중 하나만 추가하세요.

엔피엑스

npm 레지스트리에서 바로 실행합니다.

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

로컬 노드

이 방법을 사용하기 전에 종속성이 설치되어 있어야 합니다( pnpm install ).

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": [
        "tsx",
        "/PATH/TO/YOUR/PROJECT/FOLDER/src/index.ts"
      ],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

도커

이 방법을 사용하기 전에 Docker 이미지를 빌드해야 합니다.

{
  "mcpServers": {
    "discogs": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/PATH/TO/YOUR/PROJECT/FOLDER/.env",
        "discogs-mcp-server:latest"
      ]
    }
  }
}

로컬 코드를 변경하면 Claude를 다시 시작해야 적용됩니다. 또한, Claude는 MCP 도구를 실행하기 위해 사용자 참여형 상호작용(HIL)을 요구하므로 새 도구에 액세스할 때마다 Claude가 권한을 요청합니다. 일반적으로 도구당 채팅당 한 번만 권한을 요청하면 됩니다. 무료 버전을 사용하는 경우, Claude가 단일 채팅 내 컨텍스트의 양을 제한하기 때문에 긴 채팅에서 도구 실행 오류가 더 자주 발생할 수 있습니다.

할 일

OAuth 지원
누락된 도구:
- 재고 업로드

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Discogs MCP Server

Integrations