Discogs MCP 服务器

Discogs API 的 MCP 服务器，支持音乐目录操作、搜索功能等。

快速入门

如果您只想立即使用此 MCP 服务器和Claude桌面应用，而不关心开发或运行服务器，请确保您已安装Node.js并准备好 Discogs 个人访问令牌，然后直接跳到Claude 配置部分。使用该部分中的NPX方法。

致谢

此 MCP 服务器使用FastMCP构建，这是一个用于构建 MCP 服务器的 TypeScript 框架。有关 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（可选，用于运行本地 Docker 镜像，无需处理 Node 或依赖项）

设置

克隆存储库
基于.env.example在根目录下创建.env文件
在.env中设置以下所需的环境变量：
- DISCOGS_PERSONAL_ACCESS_TOKEN ：您的 Discogs 个人访问令牌

要获取您的 Discogs 个人访问令牌，请前往Discogs 的“设置”>“开发者”页面，找到您的令牌或生成一个新的。请勿分享您的令牌。OAuth 支持将在未来的版本中添加。

.env.example中的其他环境变量是可选的，并且具有合理的默认值，因此除非您有特定要求，否则无需设置它们。

本地运行服务器

选项 1：本地开发

安装依赖项：
pnpm install
可用命令：
- 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 Inspector 来测试您的本地 MCP 服务器：

pnpm run inspect

这将启动 MCP Inspector，网址为http://127.0.0.1:6274 。在浏览器中访问此 URL 即可与本地 MCP 服务器进行交互。

有关 MCP Inspector 的更多信息，请访问官方文档。

MCP 客户端

目前，此 MCP 服务器仅在 Claude Desktop 上进行了测试。未来将添加更多客户端示例。

Claude桌面配置

在Claude > Settings > Developer > Edit Config中找到您的claude_desktop_config.json ，然后根据您想要的选项，添加以下内容之一：

NPX

直接从 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

使用此方法之前应该已经构建了docker镜像。

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

任何本地代码的更改都需要重新启动 Claude 才能生效。此外，Claude 需要人机交互才能运行 MCP 工具，因此每次访问新工具时，Claude 都会请求权限。通常，每个工具每次聊天只需执行一次此操作。如果使用免费版本，由于 Claude 限制了单次聊天中的上下文数量，长时间聊天可能会导致在尝试运行工具时更频繁地出现错误。

待办事项

OAuth 支持
缺少的工具：
- 库存上传

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

Discogs MCP Server

Integrations