核心用法
setlist-mcp 是一个专门为现场音乐爱好者打造的 MCP 服务器，通过对接 setlist.fm 官方 API，让用户能够以自然语言方式查询全球演唱会曲目信息。该技能支持多种典型查询场景：查询特定艺术家在某场演出的完整歌单（如"Radiohead 昨晚演了什么"）、获取某位歌手完整巡演曲目单、搜索特定场馆的历史演出记录，或按日期/城市筛选音乐会。
核心工具链覆盖四大维度：艺术家（搜索艺人、获取艺人资料及曲目历史）、演出曲目（按多维度条件搜索、获取完整歌单及历史版本）、场馆与城市（搜索场馆、获取场馆演出记录、城市及国家信息）、用户数据（查询用户参与和编辑记录）。特别值得一提的是 setlist_resolve_concerts 批量解析工具，可一次性处理最多 24 场演出的匹配查询，并智能提供同巡演参考曲目（当目标场次为空 stub 时）。
典型使用流程遵循"搜索-定位-获取详情"模式：先通过 search_artists 或 search_venues 获取 ID，再调用具体 get_* 工具拉取详细信息。所有日期均采用 ISO 格式（yyyy-MM-dd），结果支持分页获取。
显著优点
数据源权威可靠：直接对接 setlist.fm——全球最大的现场音乐数据库，拥有数百万用户贡献的演唱会记录，数据经过社区验证和持续更新。
查询维度丰富灵活：支持 10+ 种工具组合，可从艺术家、场馆、城市、日期、巡演名称等多角度交叉查询，满足从"即兴好奇"到"深度研究"的各类需求。
自然语言友好：作为 MCP 服务器，可被 Claude 等 AI 助手直接调用，用户无需记忆复杂 API 参数，用日常语言即可触发精准查询。
批量处理能力：独有的批量解析工具大幅提升效率，特别适合音乐节策划、巡演分析、数据统计等场景。
智能补全机制：当目标场次无详细曲目时，自动关联同巡演参考场次，避免信息断档。
潜在缺点与局限性
只读操作：受限于 setlist.fm API 设计，无法提交、编辑或修正曲目信息，用户发现数据错误时只能通过官方渠道反馈。
非商业使用限制：免费 API key 仅限非商业用途，商业项目需单独申请授权，可能限制部分 B 端应用场景。
实时性依赖外部服务：数据新鲜度完全取决于 setlist.fm 社区更新速度，冷门艺人或近期演出可能存在延迟。
速率限制约束：标准 tier 约 2 请求/秒，批量查询需内置 pacing 逻辑，超量请求会被限速或标记为 pending。
无持久缓存：API 条款禁止本地缓存，每次查询都需实时调用，在高频使用场景下可能影响响应速度。
适合的目标群体
- 现场音乐爱好者/乐迷：追踪喜爱艺人的巡演动态，回顾经典场次歌单
- 音乐记者/自媒体创作者：快速核实演出信息，撰写音乐节报道或艺人专题
- 演出行业从业者：音乐节策划、场馆运营、巡演数据分析
- 音乐数据研究者：现场音乐趋势分析、艺人演出历史研究
- 票务与周边服务商：了解艺人演出热度，辅助商业决策
使用风险
API 密钥安全：需妥善保管 SETLIST_API_KEY，避免提交至公开仓库或分享给未授权方。
来源引用义务：展示结果时必须附带 setlist.fm 可点击链接，禁止 nofollow 处理，违反可能导致 API 权限被回收。
数据准确性波动：用户生成内容（UGC）模式意味着存在录入错误或遗漏可能，关键决策建议交叉验证。
网络依赖性强：完全依赖外部 API 可用性，setlist.fm 服务中断或变更将直接影响功能。
速率限制导致延迟：批量查询或高峰时段可能触发 pacing 机制，需处理 pending: true 的异步返回状态。