Discogs MCP Server

Discogs MCP サーバー

Discogs API 用の MCP サーバー。音楽カタログの操作、検索機能などを有効にします。

クイックスタート

ClaudeデスクトップアプリでこのMCPサーバーをすぐに使い始めたいだけで、開発やサーバー運用を気にしない場合は、 Node.jsがインストールされ、Discogs個人アクセストークンが準備されていることを確認してから、 Claudeの設定セクションに進んでください。そのセクションのNPXメソッドを使用してください。

目次

• 謝辞
• 利用可能なツール
• 注意点
• 前提条件
• 設定
• サーバーの実行
  • オプション1：地域開発
  • オプション2: Docker
• 検査
• MCPクライアント
  • クロードデスクトップ構成
    • NPX
    • ローカルノード
    • ドッカー
• やるべきこと
• ライセンス

謝辞

このMCPサーバーは、MCPサーバー構築用のTypeScriptフレームワークである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.jsのバージョンを確認するには、次のコマンドを実行します: node --version
• Docker (オプション、Node や依存関係を扱わずにローカルの Docker イメージを実行するため)

設定

1. リポジトリをクローンする
2. .env.exampleに基づいてルートディレクトリに.envファイルを作成します。
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 インスペクタを実行します（検査セクションを参照）
   • pnpm run format : コードのフォーマットをチェックする（よりきれいに）
   • pnpm run lint : リンターを実行します (eslint)
   • pnpm run test : vitestを実行する
   • pnpm run test:coverage : vitest v8 カバレッジを実行する
   • pnpm run version:check : package.jsonのバージョンとsrc/version.tsが一致しているかどうかを確認します

オプション2: Docker

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 インスペクターを実行して、ローカル MCP サーバーをテストします。

これにより、MCPインスペクターがhttp://127.0.0.1:6274で起動します。ブラウザでこのURLにアクセスし、ローカルMCPサーバーとやり取りしてください。

MCP Inspector の詳細については、公式ドキュメントをご覧ください。

MCPクライアント

現在、このMCPサーバーはClaude Desktopでのみテストされています。今後、さらに多くのクライアントサンプルが追加される予定です。

クロードデスクトップ構成

Claude > Settings > Developer > Edit Configでclaude_desktop_config.json見つけ、希望するオプションに応じて次のいずれか 1 つだけを追加します。

NPX

npm レジストリから直接実行します。

ローカルノード

この方法 ( pnpm install ) を使用する前に、依存関係がインストールされている必要があります。

ドッカー

この方法を使用する前に、docker イメージをビルドしておく必要があります。

ローカルコードへの変更を有効にするには、Claude を再起動する必要があります。また、Claude は MCP ツールの実行に人間による操作を必要とするため、新しいツールにアクセスするたびに許可を求めます。通常、この操作はツールごとにチャットごとに 1 回だけ実行する必要があります。無料版をご利用の場合、Claude は 1 回のチャットで処理できるコンテキストの量を制限するため、チャットが長くなるとツールの実行時にエラーが発生する頻度が高くなる可能性があります。

やるべきこと

• OAuthサポート
• 不足しているツール:
  • 在庫のアップロード

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。