[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-varunneal--spotify-mcp":3,"tool-varunneal--spotify-mcp":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":78,"owner_location":79,"owner_email":78,"owner_twitter":78,"owner_website":80,"owner_url":81,"languages":82,"stars":87,"forks":88,"last_commit_at":89,"license":90,"difficulty_score":23,"env_os":91,"env_gpu":92,"env_ram":92,"env_deps":93,"category_tags":99,"github_topics":78,"view_count":23,"oss_zip_url":78,"oss_zip_packed_at":78,"status":16,"created_at":100,"updated_at":101,"faqs":102,"releases":138},3843,"varunneal\u002Fspotify-mcp","spotify-mcp","MCP to connect your LLM with Spotify.","spotify-mcp 是一款连接大语言模型（如 Claude）与 Spotify 音乐服务的开源桥梁工具。它让 AI 助手能够直接理解并执行你的音乐指令，从而解决传统语音交互中需要手动切换应用或描述模糊的痛点。通过它，你可以用自然语言让 AI 播放、暂停、跳过歌曲，搜索艺人或专辑，甚至创建和管理播放列表，将聊天界面变身成为智能音乐控制台。\n\n这款工具特别适合喜欢折腾新技术的开发者、AI 爱好者以及希望提升工作流效率的普通用户。如果你正在使用支持 MCP 协议的客户端（如 Claude Desktop 或 Cursor），只需简单配置即可体验\"AI 点歌”的乐趣。其技术亮点在于基于成熟的 spotipy 库构建，稳定可靠，并支持通过本地部署或 uvx 快速运行，灵活适配不同开发环境。\n\n需要注意的是，由于 Spotify 官方近期调整了部分开发者接口权限，某些高级推荐功能可能受限，但核心的播放控制与曲库管理功能依然完好。对于想要探索 AI 与日常生活应用结合场景的用户来说，spotify-mcp 是一个上手友好且极具趣味性的入门项目。","# spotify-mcp MCP server\n\nMCP project to connect Claude with Spotify. Built on top of [spotipy-dev's API](https:\u002F\u002Fgithub.com\u002Fspotipy-dev\u002Fspotipy\u002Ftree\u002F2.24.0).\n\n**[Notice March 2026]: Inactive project. Most PRs will not be merged.**\n\n## Features\n\n- Start, pause, and skip playback\n- Search for tracks\u002Falbums\u002Fartists\u002Fplaylists\n- Get info about a track\u002Falbum\u002Fartist\u002Fplaylist\n- Manage the Spotify queue\n- Manage, create, and update playlists\n\n## Demo\n\n\u003Cdetails>\n  \u003Csummary>\n    Video -- turn on audio\n  \u003C\u002Fsummary>\n  https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F20ee1f92-f3e3-4dfa-b945-ca57bc1e0894\n\u003C\u002Fdetails>\n\n## Configuration\n\n### Getting Spotify API Keys\n\nCreate an account on [developer.spotify.com](https:\u002F\u002Fdeveloper.spotify.com\u002F). Navigate to [the dashboard](https:\u002F\u002Fdeveloper.spotify.com\u002Fdashboard). \nCreate an app with redirect_uri as http:\u002F\u002F127.0.0.1:8080\u002Fcallback. \nYou can choose any port you want but you must use http and an explicit loopback address (IPv4 or IPv6).\n\nSee [here](https:\u002F\u002Fdeveloper.spotify.com\u002Fdocumentation\u002Fweb-api\u002Fconcepts\u002Fredirect_uri) for more info\u002Ftroubleshooting. \nYou may have to restart your MCP environment (e.g. Claude Desktop) once or twice before it works.\n\n### Locating MCP Config\n\nFor Cursor, Claude Desktop, or any other MCP-enabled client you will have to locate your config.\n\n- Claude Desktop location on MacOS: `~\u002FLibrary\u002FApplication\\ Support\u002FClaude\u002Fclaude_desktop_config.json`\n\n- Claude Desktop location on Windows: `%APPDATA%\u002FClaude\u002Fclaude_desktop_config.json`\n\n\n### Run this project with uvx\n\nAdd this snippet to your MCP Config.\n\n```json\n{\n  \"mcpServers\": {\n    \"spotify\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--python\", \"3.12\",\n        \"--from\", \"git+https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\",\n        \"spotify-mcp\"\n      ],\n      \"env\": {\n        \"SPOTIFY_CLIENT_ID\": YOUR_CLIENT_ID,\n        \"SPOTIFY_CLIENT_SECRET\": YOUR_CLIENT_SECRET,\n        \"SPOTIFY_REDIRECT_URI\": \"http:\u002F\u002F127.0.0.1:8080\u002Fcallback\"\n      }\n    }\n  }\n}\n```\n\n### Run this project locally\n\nUsing UVX will open the spotify redirect URI for every tool call. To avoid this, you can run this project locally by cloning this repo:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp.git\n```\n\nAdd it to your MCP Config like this:\n\n  ```json\n  \"spotify\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"\u002Fpath\u002Fto\u002Fspotify-mcp\",\n        \"run\",\n        \"spotify-mcp\"\n      ],\n      \"env\": {\n        \"SPOTIFY_CLIENT_ID\": YOUR_CLIENT_ID,\n        \"SPOTIFY_CLIENT_SECRET\": YOUR_CLIENT_SECRET,\n        \"SPOTIFY_REDIRECT_URI\": \"http:\u002F\u002F127.0.0.1:8080\u002Fcallback\"\n      }\n    }\n  ```\n\n### Troubleshooting\n\nPlease open an issue if you can't get this MCP working. Here are some tips:\n\n1. Make sure `uv` is updated. I recommend version `>=0.54`.\n2. If cloning locally, enable execution permisisons for the project: `chmod -R 755`.\n3. Ensure you have Spotify premium (needed for running developer API). \n\nThis MCP will emit logs to std err (as specified in the MCP) spec. On Mac the Claude Desktop app should emit these logs\nto `~\u002FLibrary\u002FLogs\u002FClaude`. \nOn other platforms [you can find logs here](https:\u002F\u002Fmodelcontextprotocol.io\u002Fquickstart\u002Fuser#getting-logs-from-claude-for-desktop).\n\n\nYou can launch the MCP Inspector via [`npm`](https:\u002F\u002Fdocs.npmjs.com\u002Fdownloading-and-installing-node-js-and-npm) with this command:\n\n```bash\nnpx @modelcontextprotocol\u002Finspector uv --directory \u002Fpath\u002Fto\u002Fspotify-mcp run spotify-mcp\n```\n\nUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.\n\n## TODO\n\nUnfortunately, a bunch of cool features have [now been deprecated](https:\u002F\u002Ftechcrunch.com\u002F2024\u002F11\u002F27\u002Fspotify-cuts-developer-access-to-several-of-its-recommendation-features\u002F)\nfrom the Spotify API. Most new features will be relatively minor or for the health of the project:\n\n- tests.\n- ~~adding API support for managing playlists.~~\n- adding API support for paginated search results\u002Fplaylists\u002Falbums.\n\nPRs appreciated! Thanks to @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj, @JJGO and others for contributions.  \n\n[\u002F\u002F]: # (## Deployment)\n\n[\u002F\u002F]: # ((todo))\n\n[\u002F\u002F]: # (### Building and Publishing)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (To prepare the package for distribution:)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (1. Sync dependencies and update lockfile:)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (```bash)\n\n[\u002F\u002F]: # (uv sync)\n\n[\u002F\u002F]: # (```)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (2. Build package distributions:)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (```bash)\n\n[\u002F\u002F]: # (uv build)\n\n[\u002F\u002F]: # (```)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (This will create source and wheel distributions in the `dist\u002F` directory.)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (3. Publish to PyPI:)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (```bash)\n\n[\u002F\u002F]: # (uv publish)\n\n[\u002F\u002F]: # (```)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (Note: You'll need to set PyPI credentials via environment variables or command flags:)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (- Token: `--token` or `UV_PUBLISH_TOKEN`)\n\n[\u002F\u002F]: # (- Or username\u002Fpassword: `--username`\u002F`UV_PUBLISH_USERNAME` and `--password`\u002F`UV_PUBLISH_PASSWORD`)\n","# spotify-mcp MCP 服务器\n\nMCP 项目用于将 Claude 与 Spotify 连接起来。基于 [spotipy-dev 的 API](https:\u002F\u002Fgithub.com\u002Fspotipy-dev\u002Fspotipy\u002Ftree\u002F2.24.0) 构建。\n\n**[2026年3月公告]：该项目已停止维护。大多数拉取请求将不会被合并。**\n\n## 功能\n\n- 开始、暂停和跳过播放\n- 搜索曲目、专辑、艺术家和播放列表\n- 获取曲目、专辑、艺术家和播放列表的信息\n- 管理 Spotify 队列\n- 管理、创建和更新播放列表\n\n## 演示\n\n\u003Cdetails>\n  \u003Csummary>\n    视频 -- 请打开音频\n  \u003C\u002Fsummary>\n  https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F20ee1f92-f3e3-4dfa-b945-ca57bc1e0894\n\u003C\u002Fdetails>\n\n## 配置\n\n### 获取 Spotify API 密钥\n\n在 [developer.spotify.com](https:\u002F\u002Fdeveloper.spotify.com\u002F) 上创建一个账户。导航到 [控制台](https:\u002F\u002Fdeveloper.spotify.com\u002Fdashboard)。\n创建一个应用，将 redirect_uri 设置为 http:\u002F\u002F127.0.0.1:8080\u002Fcallback。\n您可以选择任何端口，但必须使用 http 协议和明确的回环地址（IPv4 或 IPv6）。\n\n更多信息和故障排除，请参阅 [此处](https:\u002F\u002Fdeveloper.spotify.com\u002Fdocumentation\u002Fweb-api\u002Fconcepts\u002Fredirect_uri)。\n您可能需要重启一次或两次您的 MCP 环境（例如 Claude Desktop），才能使其正常工作。\n\n### 找到 MCP 配置文件\n\n对于 Cursor、Claude Desktop 或任何其他支持 MCP 的客户端，您都需要找到您的配置文件。\n\n- 在 macOS 上，Claude Desktop 的配置文件位置为：`~\u002FLibrary\u002FApplication\\ Support\u002FClaude\u002Fclaude_desktop_config.json`\n- 在 Windows 上，Claude Desktop 的配置文件位置为：`%APPDATA%\u002FClaude\u002Fclaude_desktop_config.json`\n\n### 使用 uvx 运行该项目\n\n将以下代码片段添加到您的 MCP 配置中。\n\n```json\n{\n  \"mcpServers\": {\n    \"spotify\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--python\", \"3.12\",\n        \"--from\", \"git+https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\",\n        \"spotify-mcp\"\n      ],\n      \"env\": {\n        \"SPOTIFY_CLIENT_ID\": YOUR_CLIENT_ID,\n        \"SPOTIFY_CLIENT_SECRET\": YOUR_CLIENT_SECRET,\n        \"SPOTIFY_REDIRECT_URI\": \"http:\u002F\u002F127.0.0.1:8080\u002Fcallback\"\n      }\n    }\n  }\n}\n```\n\n### 在本地运行该项目\n\n使用 UVX 会在每次调用工具时打开 Spotify 的重定向 URI。为了避免这种情况，您可以克隆此仓库并在本地运行：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp.git\n```\n\n然后将其添加到您的 MCP 配置中，如下所示：\n\n```json\n\"spotify\": {\n    \"command\": \"uv\",\n    \"args\": [\n      \"--directory\",\n      \"\u002Fpath\u002Fto\u002Fspotify-mcp\",\n      \"run\",\n      \"spotify-mcp\"\n    ],\n    \"env\": {\n      \"SPOTIFY_CLIENT_ID\": YOUR_CLIENT_ID,\n      \"SPOTIFY_CLIENT_SECRET\": YOUR_CLIENT_SECRET,\n      \"SPOTIFY_REDIRECT_URI\": \"http:\u002F\u002F127.0.0.1:8080\u002Fcallback\"\n    }\n  }\n```\n\n### 故障排除\n\n如果您无法使此 MCP 正常工作，请提交一个问题。以下是一些提示：\n\n1. 确保 `uv` 已更新。建议使用 `>=0.54` 版本。\n2. 如果是本地克隆，请为项目启用执行权限：`chmod -R 755`。\n3. 确保您拥有 Spotify Premium 账户（运行开发者 API 所需）。\n\n此 MCP 将按照 MCP 规范将日志输出到标准错误流。在 Mac 上，Claude Desktop 应该会将这些日志输出到 `~\u002FLibrary\u002FLogs\u002FClaude`。\n在其他平台上，[您可以在这里找到日志](https:\u002F\u002Fmodelcontextprotocol.io\u002Fquickstart\u002Fuser#getting-logs-from-claude-for-desktop)。\n\n您可以通过 [`npm`](https:\u002F\u002Fdocs.npmjs.com\u002Fdownloading-and-installing-node-js-and-npm) 使用以下命令启动 MCP 检查器：\n\n```bash\nnpx @modelcontextprotocol\u002Finspector uv --directory \u002Fpath\u002Fto\u002Fspotify-mcp run spotify-mcp\n```\n\n启动后，检查器会显示一个 URL，您可以在浏览器中访问该 URL 来开始调试。\n\n## 待办事项\n\n不幸的是，Spotify API 中的一些很酷的功能已经被 [弃用](https:\u002F\u002Ftechcrunch.com\u002F2024\u002F11\u002F27\u002Fspotify-cuts-developer-access-to-several-of-its-recommendation-features\u002F)。大多数新功能都相对较小，或者是为了项目的健康而进行的改进：\n\n- 测试。\n- ~~增加对管理播放列表的 API 支持。~~\n- 增加对分页搜索结果、播放列表和专辑的 API 支持。\n\n欢迎贡献 PR！感谢 @jamiew、@davidpadbury、@manncodes、@hyuma7、@aanurraj、@JJGO 等人的贡献。\n\n[\u002F\u002F]: # (## 部署)\n\n[\u002F\u002F]: # ((待办))\n\n[\u002F\u002F]: # (### 构建和发布)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (为了准备软件包进行分发：)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (1. 同步依赖并更新锁定文件：)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (```bash)\n\n[\u002F\u002F]: # (uv sync)\n\n[\u002F\u002F]: # (```)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (2. 构建软件包分发：)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (```bash)\n\n[\u002F\u002F]: # (uv build)\n\n[\u002F\u002F]: # (```)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (这将在 `dist\u002F` 目录下生成源码和 wheel 分发包。)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (3. 发布到 PyPI：)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (```bash)\n\n[\u002F\u002F]: # (uv publish)\n\n[\u002F\u002F]: # (```)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (注意：您需要通过环境变量或命令行参数设置 PyPI 凭证：)\n\n[\u002F\u002F]: # ()\n[\u002F\u002F]: # (- Token：`--token` 或 `UV_PUBLISH_TOKEN`)\n\n[\u002F\u002F]: # (- 或用户名\u002F密码：`--username`\u002F`UV_PUBLISH_USERNAME` 和 `--password`\u002F`UV_PUBLISH_PASSWORD`)","# spotify-mcp 快速上手指南\n\n`spotify-mcp` 是一个 MCP 服务器，旨在将 Claude 与 Spotify 连接，让你可以通过自然语言控制音乐播放、搜索曲目及管理播放列表。\n\n> **注意**：该项目目前处于非活跃维护状态（截至 2026 年 3 月），大部分新功能请求可能不会被合并，但核心功能仍可使用。\n\n## 环境准备\n\n在开始之前，请确保满足以下条件：\n\n1.  **Spotify 账号**：必须拥有 **Spotify Premium** 订阅（开发者 API 限制）。\n2.  **系统要求**：macOS 或 Windows。\n3.  **前置依赖**：\n    *   安装 [`uv`](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) (推荐版本 `>=0.54`)。\n    *   安装支持 MCP 的客户端（如 Claude Desktop 或 Cursor）。\n4.  **获取 API 密钥**：\n    *   访问 [Spotify Developer Dashboard](https:\u002F\u002Fdeveloper.spotify.com\u002Fdashboard) 登录并创建应用。\n    *   设置 **Redirect URI** 为 `http:\u002F\u002F127.0.0.1:8080\u002Fcallback`（端口可自定义，但必须是 http 和本地回环地址）。\n    *   记录生成的 `Client ID` 和 `Client Secret`。\n\n## 安装步骤\n\n你需要将配置添加到 MCP 客户端的配置文件中。\n\n### 1. 定位配置文件\n\n根据你的操作系统和客户端，找到配置文件路径：\n\n*   **macOS (Claude Desktop)**: `~\u002FLibrary\u002FApplication\\ Support\u002FClaude\u002Fclaude_desktop_config.json`\n*   **Windows (Claude Desktop)**: `%APPDATA%\u002FClaude\u002Fclaude_desktop_config.json`\n*   **Cursor**: 通常在设置中通过 \"MCP Servers\" 界面管理，或直接编辑对应的 JSON 配置。\n\n### 2. 配置服务器\n\n推荐使用 `uvx` 方式运行，无需克隆代码即可直接使用。将以下片段添加到配置文件的 `mcpServers` 对象中，并替换你的密钥：\n\n```json\n{\n  \"mcpServers\": {\n    \"spotify\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--python\", \"3.12\",\n        \"--from\", \"git+https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\",\n        \"spotify-mcp\"\n      ],\n      \"env\": {\n        \"SPOTIFY_CLIENT_ID\": \"你的_CLIENT_ID\",\n        \"SPOTIFY_CLIENT_SECRET\": \"你的_CLIENT_SECRET\",\n        \"SPOTIFY_REDIRECT_URI\": \"http:\u002F\u002F127.0.0.1:8080\u002Fcallback\"\n      }\n    }\n  }\n}\n```\n\n> **提示**：保存配置后，可能需要重启一次或两次 MCP 客户端（如 Claude Desktop）以使更改生效。首次运行时，浏览器会弹出 Spotify 授权页面，请点击同意以完成连接。\n\n*(可选) 本地运行模式*：如果你希望避免每次调用工具都打开重定向 URI，可以克隆仓库并在本地运行：\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp.git\nchmod -R 755 spotify-mcp  # macOS\u002FLinux 需要执行此步赋予权限\n```\n然后将配置中的 `command` 改为 `uv`，`args` 调整为指向本地路径：\n```json\n\"command\": \"uv\",\n\"args\": [\n  \"--directory\",\n  \"\u002Fpath\u002Fto\u002Fspotify-mcp\",\n  \"run\",\n  \"spotify-mcp\"\n]\n```\n\n## 基本使用\n\n配置成功并重启客户端后，你可以在对话框中直接使用自然语言指令控制 Spotify。\n\n**使用示例：**\n\n*   **播放控制**：\n    > \"帮我播放周杰伦的《七里香》。\"\n    > \"暂停当前播放。\"\n    > \"跳过这首歌。\"\n\n*   **搜索与信息**：\n    > \"搜索一下 Taylor Swift 的最新专辑。\"\n    > \"告诉我当前正在播放的歌曲信息。\"\n\n*   **播放列表管理**：\n    > \"创建一个名为'工作专注'的新播放列表。\"\n    > \"把当前歌曲添加到我的'喜欢的音乐'列表中。\"\n    > \"显示我的播放队列。\"\n\n只需像与人交谈一样发出指令，AI 将自动调用 Spotify API 执行相应操作。","一位数据分析师正在撰写关于“不同音乐流派对编程效率影响”的技术博客，需要实时调用个人 Spotify 账号数据来验证观点并控制播放环境。\n\n### 没有 spotify-mcp 时\n- **操作割裂严重**：必须在浏览器、Spotify 客户端和代码编辑器之间频繁切换，手动搜索歌曲或复制专辑链接，打断写作心流。\n- **数据获取繁琐**：若要分析特定歌单的曲目详情（如 BPM、时长），需先导出 CSV 或编写独立的 Python 脚本调用 API，无法在对话中即时获取。\n- **上下文丢失**：向 AI 描述想听的歌曲时，无法直接让 AI 理解当前的播放队列，导致推荐结果与实际听歌场景脱节。\n- **自动化缺失**：无法通过自然语言指令直接暂停、跳过或调整播放列表，必须依赖手动点击，降低了多任务处理效率。\n\n### 使用 spotify-mcp 后\n- **交互无缝融合**：直接在 Claude 对话框中输入“播放适合深度工作的 Lo-Fi 歌单”，spotify-mcp 立即接管播放控制，无需离开当前窗口。\n- **实时数据洞察**：询问“当前播放歌曲的艺术家还有哪些类似风格的专辑？”，工具即时检索元数据并返回结构化信息，辅助内容创作。\n- **智能队列管理**：指令“将这首曲子加入‘编码专用’播放列表并跳过当前曲目”，spotify-mcp 自动执行队列更新，保持专注状态。\n- **动态场景联动**：根据写作进度自动调整音乐节奏，例如检测到长时间无输入时，主动建议切换高能量曲目以提振精神。\n\nspotify-mcp 将原本割裂的音乐控制与数据查询能力转化为大模型的原生技能，实现了“所想即所听”的智能化工作流闭环。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fvarunneal_spotify-mcp_a201af6b.png","varunneal","Varun Srivastava","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fvarunneal_909aa8e6.jpg",null,"nyc","https:\u002F\u002Fvarunneal.github.io\u002F","https:\u002F\u002Fgithub.com\u002Fvarunneal",[83],{"name":84,"color":85,"percentage":86},"Python","#3572A5",100,593,123,"2026-04-01T18:35:49","MIT","macOS, Windows, Linux","未说明",{"notes":94,"python":95,"dependencies":96},"需要 Spotify Premium 账户才能运行开发者 API；必须配置 Spotify Developer Dashboard 获取 Client ID 和 Secret，并设置重定向 URI（如 http:\u002F\u002F127.0.0.1:8080\u002Fcallback）；推荐使用 uv 工具管理环境和运行；该项目已于 2026 年 3 月标记为非活跃状态，大部分 PR 将不被合并。","3.12",[97,98],"uv>=0.54","spotipy==2.24.0",[45,15],"2026-03-27T02:49:30.150509","2026-04-06T07:16:15.887994",[103,108,113,118,123,128,133],{"id":104,"question_zh":105,"answer_zh":106,"source_url":107},17592,"遇到 'Premium required' (需要高级账户) 错误怎么办？","首先确认您的 Spotify 账户确实是 Premium 会员。如果已是会员但仍报错，请仔细检查环境变量 `SPOTIFY_CLIENT_ID` 和 `SPOTIFY_CLIENT_SECRET` 是否配置正确。如果随后出现 'Invalid client' 错误，通常也意味着客户端凭证配置有误。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F1",{"id":109,"question_zh":110,"answer_zh":111,"source_url":112},17593,"运行时报错 '[Errno 48] Address already in use' (地址已被占用) 如何解决？","这通常是因为端口被之前的进程占用或未正确释放。建议检查 Spotify Developer Portal 中设置的回调 URL 端口。您可以使用命令 `lsof -i :\u003C端口号>` (例如 `lsof -i :4343`) 查找占用端口的进程并终止它。如果问题持续，尝试在配置中更换一个不同的端口。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F2",{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},17594,"在 Cursor 或 VS Code 中提示 'No tools' (没有工具) 怎么办？","该问题通常已通过更新代码修复。维护者已提交相关 commit 解决了工具加载问题。请确保您拉取了最新的代码版本。如果是 VS Code 用户，更新后通常能立即生效；Cursor 用户也请尝试同步最新更改。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F12",{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},17595,"配置 MCP 服务器时遇到 'spawn uv ENOENT' 错误是什么原因？","这表示系统找不到 `uv` 命令，通常是因为 Claude Desktop 无法读取到您的环境变量路径。即使终端中可以正常运行 `uv`，GUI 应用可能无法识别。建议参考 Model Context Protocol 的相关讨论修复环境变量配置，或者将 `uv` 的路径显式添加到配置中。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F13",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},17596,"Spotify 回调 URL (Redirect URI) 设置有什么新要求？","Spotify 已弃用 `localhost` 作为回调地址。从 2025 年 4 月 9 日起，新应用必须使用明确的 IP 地址。请将 Spotify Dashboard 中的 Redirect URI 设置为 `http:\u002F\u002F127.0.0.1:\u003C端口>\u002Fcallback` (例如 `http:\u002F\u002F127.0.0.1:8888\u002Fcallback`) 或 IPv6 格式 `http:\u002F\u002F[::1]:\u003C端口>\u002Fcallback`，不要再用 `localhost`。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F18",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},17597,"如何在 Spotify Dashboard 设置安全的重定向 URI？","如果在创建应用时设置 `http:\u002F\u002F` 开头的本地地址被提示 'This redirect URI is not secure'，请确保使用的是环回地址的具体 IP 形式（如 `127.0.0.1`）而非域名 `localhost`。根据最新规范，使用 `http:\u002F\u002F127.0.0.1:8888\u002Fcallback` 通常能被接受用于本地开发调试。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F29",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},17598,"项目依赖的 spotipy 库存在安全漏洞怎么办？","如果您运行审计工具发现 `spotipy@2.24.0` 存在 CVE-2025-27154 漏洞，请将依赖升级到 `spotipy>=2.25.1`。维护者确认该漏洞在新版本中已修复，只需更新依赖即可解决。","https:\u002F\u002Fgithub.com\u002Fvarunneal\u002Fspotify-mcp\u002Fissues\u002F52",[]]