MCP 服务器

Discogs MCP Server

Discogs 的 MCP 服务器

cswkim

开发者工具

访问服务器

README

Discogs MCP 服务器

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

快速开始

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

致谢

此 MCP 服务器是使用 FastMCP 构建的，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.x.x 进行测试，但 18.x.x 也应该可以工作）
- 使用以下命令检查您的 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 Inspector（请参阅检查部分）
- pnpm run format: 检查代码格式 (prettier)
- 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

构建 Docker 镜像：

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

运行容器：

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

对于 SSE 传输模式：

# 端口应与您的 .env 文件中的端口匹配
docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest sse

检查

运行 MCP Inspector 以测试您的本地 MCP 服务器：

pnpm run inspect

这将在 http://127.0.0.1:6274 启动 MCP Inspector。在您的浏览器中访问此 URL 以与您的本地 MCP 服务器交互。

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

MCP 客户端

目前，此 MCP 服务器仅已使用 Claude Desktop 进行测试。将来会添加更多客户端示例。

Claude 桌面配置

在 Claude > 设置 > 开发者 > 编辑配置 中找到您的 claude_desktop_config.json，并根据您想要的选择，添加以下仅一个：

NPX

直接从 npm 注册表运行它。

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

本地 Node

在使用此方法之前，应已安装依赖项 (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 限制了单个聊天中的上下文量。