1001 Albums Generator MCP

1001 Albums Generator MCP

AI-powered exploration of your 1001 Albums listening journey

Install · Tools · Prompts · Contributing

______________________________________________________________________

______________________________________________________________________

这是什么？

1001相册生成器 --建造于 u/SidledsGunnar --是一个web应用程序，它一次从规范中为您分配一个相册 _死前必听的1001张专辑_ 这是一种系统地探索音乐史的绝佳方式，它会在你前进的过程中悄悄地积累丰富的个人数据集：你的评分、书面评论、你的收听时间表。

1001相册生成器MCP 通过以下方式将该数据集连接到AI助手 模型上下文协议，所以你可以通过自然对话来探索它，而不是手动浏览网站。

You:    What's today's album?
Claude: Today's album is Miles Davis — Kind of Blue (1959).
        One of the most influential jazz recordings ever made, featuring
        Coltrane, Cannonball Adderley, and Bill Evans. Community rating: ★ 4.63

______________________________________________________________________

能力

______________________________________________________________________

安装

注： 此服务器强制执行 20秒最小间隔 在上游API调用和缓存响应之间 4小时 以保持在每分钟3个请求的上游速率限制内。缓存未命中后的第一个请求可能很慢——这是 1001专辑生成器API，而不是服务器。

选项A-Claude MCP捆绑包 _（推荐）_

远程版本不需要Node.js。

1. 去 发布页面 并下载 .mcpb 文件：

1. 打开 克劳德桌面版→ 设置→ 扩展

1. 拖放 .mcpb 文件进入窗口

______________________________________________________________________

选项B——远程HTTP服务器 _（不安装）_

将任何MCP客户端指向托管服务器：

https://1001-albums-mcp.bnm12.dk/mcp

克劳德桌面版 (claude_desktop_config.json):

{
  "mcpServers": {
    "1001-albums": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://1001-albums-mcp.bnm12.dk/mcp"]
    }
  }
}

______________________________________________________________________

选项C——本地安装

要求： Node.js 18+

git clone https://github.com/bnm12/1001-albums-generator-mcp.git
cd 1001-albums-generator-mcp
npm install && npm run build

克劳德桌面版 (claude_desktop_config.json):

{
  "mcpServers": {
    "1001-albums": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { "MCP_MODE": "stdio" }
    }
  }
}

作为HTTP服务器 （对于任何通过HTTP的MCP客户端）：

MCP_MODE=http PORT=3000 node dist/index.js
# Endpoint: http://localhost:3000/mcp

更改任何配置后重新启动Claude Desktop。

______________________________________________________________________

MCP工具参考

项目工具

元工具

分析工具

组工具

社区工具

______________________________________________________________________

¹列表和搜索工具返回a 超薄格式 --没有评论、流媒体链接或图像。使用 get_album_detail 当你需要书面评论、Spotify/Apple Music链接或完整的流派分类时。

²按名称、UUID或 generatedAlbumId （可从列表/搜索结果中获得）。

³ get_review_insights 尝试使用 MCP采样 综合评论。包括Claude Desktop在内的大多数客户端目前都不支持采样——该工具会自动退回原始评论，并附上合成说明，供代理直接完成。无论哪种方式，输出质量都是相等的。

______________________________________________________________________

提示模板

兼容的客户端（例如Claude Desktop）将这些作为一键对话的发起者。

______________________________________________________________________

示例提示

每日

What's today's album from my project?
Give me a personalised pitch for why I should care about today's album.
Predict how I'll rate today's album and explain your reasoning.

历史与品味

Build a full profile of my music taste.
Which decade dominates my listening history?
Which albums did I rate way above the community average?
How has my taste evolved over time?

发现

Give me a deep dive on Kind of Blue from my history.
Find connections between the last five albums I listened to.
What does my review history say about what I actually value in music?

群组

What did everyone in our group think of the latest album?
Who in our group has the most similar taste to me?
Which album has divided our group the most?

______________________________________________________________________

贡献

欢迎捐款。一些想法：

• 新的分析工具（推荐引擎、情绪推理、BPM/关键数据）
• 更深入的流派聚类
• 视觉收听统计数据

打开PR之前，运行完整的检查套件：

npx tsc --noEmit   # strict TypeScript
npm run lint       # ESLint
npm run build
npm test

添加工具时，请在中注册 createMcpServer() 在 src/index.ts 并更新 README.md, AGENTS.md，以及 src/content/resources/tool-guide.md。更新后的工具指南由以下人员自动返回 get_tool_guide --不需要额外的步骤。看 代理商.md 查看完整的贡献指南。

______________________________________________________________________

许可证

ISC ©2026 bnm12

______________________________________________________________________

Built for music nerds doing the 1001 Albums challenge

Thanks to u/SidledsGunnar for building the generator that makes all of this possible

Powered by Model Context Protocol