AI导哈

专辑生成器

1001 Albums Generator MCP 是一个AI驱动的音乐探索工具，通过自然对话帮助用户探索和管理他们的1001 Albums Generator听歌旅程。

  • by bnm12
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 bnm12/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

能力

领域 AI能做什么
🎵 日常倾听 检索今天的专辑，包括背景、上下文和个人音调
📚 历史 浏览、搜索和探索您的完整听力档案
📊 味道分析 类型亲和力、十年分布、评级趋势、社区对齐
🧠 模式识别 弧线分析、里程碑检测、倾听旅程叙事
🔍 回顾见解 综合你的书面评论，了解你自己的口味
👥 群组 比较成员，找到有分歧的专辑，映射口味兼容性

安装

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

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

远程版本不需要Node.js。

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

    文件 它的作用
    *-remote.mcpb 连接到托管服务器——零本地设置
    *-local.mcpb 在您的计算机上本地运行MCP服务器

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

  3. 拖放 .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工具参考

项目工具

工具 说明
get_album_of_the_day 今天分配的相册，包含完整的元数据和项目注释
get_project_stats 进度摘要：已生成、已评级、未评级、当前专辑
list_project_history¹ 带排序和分页的完整历史记录
search_project_history 按艺术家、专辑、年份、流派或角色搜索历史记录——多词查询使用or匹配
get_album_detail² 一张专辑的全部细节：评论、流媒体链接、子类型
get_album_context 艺术家弧线、音乐连接、社区分歧、聆听之旅

元工具

工具 说明
get_tool_guide 返回完整的工作流程指南——推荐的工具序列、信号加权、常见错误

分析工具

工具 说明
get_taste_profile 类型、年代、评级趋势、社区对齐
get_rating_outliers 您的评分与社区差异最大的专辑
get_review_insights³ 将你的书面评论综合成定性的品味洞察
get_listening_arc 具有趋势和里程碑的分段旅程分析

组工具

工具 说明
get_group 总结：成员，当前专辑，历史最高/最低
get_group_latest_album 所有成员投票的最新团体专辑
get_group_album_reviews 每个成员对特定专辑的评分和评论
get_group_album_insights 按评级差异划分的最具争议性和最具共识的专辑
get_group_member_comparison 两个成员的并排口味比较
get_group_compatibility_matrix 集团范围内的成对兼容性——谁同意谁
compare_projects 任意两个项目的高级比较

社区工具

工具 说明
list_book_album_stats 所有约1001本经典图书专辑的社区评级
get_book_album_stat 按姓名、艺术家、流派或年份搜索图书相册
list_user_submitted_album_stats 图书列表外用户提交相册的统计信息
refresh_data 强制刷新任何数据集的缓存数据

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

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

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

提示模板

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

提示 描述
todays-album 今天指定专辑的背景和上下文
predict-my-rating 根据您的历史记录预测您将如何评价今天的专辑
taste-profile 全面品味分析和听众原型
album-deep-dive 对您历史中特定专辑的深入上下文分析
rating-outliers 你的品味与社区分歧最大的地方
genre-journey 你的流派曝光率是如何随着时间的推移而演变的
listening-wrapped Spotify环绕式收听历史摘要
personalized-pitch 针对特定专辑的有说服力、有品味的案例
group-latest-album 您的团队如何评价他们的最新专辑
group-compatibility 你们组中谁的口味最相似，也最不一样
group-divisive-albums 分裂你的团队的专辑，以及你们都同意的专辑
compare-members 两组成员的详细口味比较

示例提示

每日

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

相关 MCP