Discogs MCP Server

断开MCP服务器

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

快速入门

如果您只想立即开始使用此MCP服务器 克劳德 桌面应用程序，不关心开发或自己运行服务器，然后确保你有 已安装，您的Discogs个人访问令牌已准备就绪，直接跳到 Claude配置部分.使用 NPX 该部分的方法。

目录

• 致谢
• 可用工具
• 注意事项
• 先决条件
• 设置
• 运行服务器

- 方案1：地方发展 -

• 检查
• MCP客户端

- Claude桌面配置 - NPX - 本地节点 - 码头工人 - Librechat - LM 工作室

• 待办事项
• 许可证

致谢

可用工具

查看可用工具列表： TOOLS.md

注意事项

• 这 不符合API文件 不完美，一些端点可能没有完全记录或可能存在不一致。
• 由于API端点和响应类型数量巨大，因此无法验证每个可能响应的类型安全性。请报告您遇到的任何与类型相关的问题。
• 此MCP服务器允许编辑Discogs集合中的数据。请谨慎使用，并在执行操作之前验证您的操作。
• Discogs API per_page 默认值为 50，对于某些客户来说，这可能是太多的数据，无法有效处理，因此在这个项目中 discogs.config.defaultPerPage 值已设置为 5。您可以在提示中请求更多数据，但请注意，一些客户端可能难以获得更大的响应。

先决条件

• Node.js（用Node.js测试 20.x.x但是 18.x.x 也应该工作）

- 检查你的Node.js版本： node --version

• Docker（可选，用于运行本地Docker镜像，而无需处理Node或依赖关系）

设置

1. 克隆存储库
2. 创建一个 .env 根目录中的文件基于 .env.example
3. 在您的 .env:

- DISCOGS_PERSONAL_ACCESS_TOKEN：您的Discogs个人访问令牌

要获取您的Discogs个人访问令牌，请访问 Discogs设置>开发者 页面并找到您的令牌或生成一个新的令牌。 _不要共享您的令牌_OAuth支持将在未来的版本中添加。

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

• SERVER_HOST：将服务器绑定到的主机地址（默认值： 0.0.0.0).吃起来 0.0.0.0 允许从容器/机器外部进行连接，或 127.0.0.1 仅限于本地主机。

在本地运行服务器

方案1：地方发展

1. 安装依赖项：

   pnpm install

1. 可用命令：

- pnpm run dev：通过热重新加载启动开发服务器 - pnpm run dev:stream：在HTTP流模式下以热重载启动开发服务器 - 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覆盖率 - pnpm run version:check：检查package.json版本和src/version.ts是否匹配

选项2:Docker

1. 构建Docker镜像：

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

1. 运行容器：

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

对于HTTP流传输模式：

   # The port should match what is in your .env file
   # By default, the server listens on 0.0.0.0, allowing connections from outside the container
   docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest stream

检查

运行MCP检查器以测试本地MCP服务器：

pnpm run inspect

这将在以下时间启动MCP检查器 http://127.0.0.1:6274。在浏览器中访问此URL以与本地MCP服务器交互。

有关MCP检查器的更多信息，请访问 官方文件.

MCP客户端

未来将添加更多客户端示例。如果你想为特定的客户端进行配置，可以 通过打开一个新问题或创建pull请求来编辑README的这一部分。

Claude桌面配置

找到你的 claude_desktop_config.json 在 Claude > Settings > Developer > Edit Config 根据您想要的选项，添加 只有一个 以下内容：

NPX

直接从npm注册表运行它。

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

本地节点

在使用此方法之前，应该已经安装了依赖项(pnpm install).

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": [
        "tsx",
        "/PATH/TO/YOUR/PROJECT/FOLDER/src/index.ts"
      ],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_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工具运行，因此每次访问新工具时，Claude都会请求许可。您通常只需在每次聊天中为每个工具执行一次此操作。 _如果使用免费版本，长时间聊天可能会导致尝试运行工具时出现更频繁的错误，因为Claude限制了单个聊天中的上下文数量。_

Librechat

在 librechat.yaml 配置文件，将其添加到 mcpServers 章节：

discogs:
  type: stdio
  command: npx
  args: ["-y", "discogs-mcp-server"]
  env:
    DISCOGS_PERSONAL_ACCESS_TOKEN: YOUR_TOKEN_GOES_HERE

LM 工作室

进入聊天室 Settings.在 Program 选项卡中会有一个下拉菜单，默认值为 Install。选择 Edit mcp.json.在下面添加此项 mcpServers 章节：

"discogs": {
  "command": "npx",
  "args": [
    "-y",
    "discogs-mcp-server"
  ],
  "env": {
    "DISCOGS_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_GOES_HERE"
  }
}

保存后，在 Program 选项卡现在应该有一个 mcp/discogs 切换以启用服务器。在每个聊天框中都有一个 Integrations 菜单，您还可以在其中启用mcp服务器。

待办事项

• OAuth支持
• 缺少工具：

- 库存上传

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。