music-mcp

music-mcp

site icon
2025.01.17 0
Python音乐管理娱乐功能
music-mcp 是一个基于 Model Context Protocol (MCP) 的服务,旨在帮助用户通过 Claude 管理音乐。它集成了 Spotify 的功能,允许用户通过 Claude 进行音乐管理。
View on GitHub

Overview

基本能力

产品定位

music-mcp 是一个音乐管理服务,通过与 Claude 和 Spotify 的集成,提供便捷的音乐管理功能。

核心功能

  • 通过 Claude 进行音乐管理
  • 集成 Spotify 功能
  • 支持 Spotify 客户端 ID、密钥和重定向 URI 的配置

适用场景

  • 用户希望通过 Claude 管理 Spotify 音乐
  • 开发者需要集成音乐管理功能到自己的应用中

工具列表

  • uv: 用于运行 MCP 服务
  • Spotify Application: 提供音乐管理功能

常见问题解答

使用教程

使用依赖

安装教程

  1. 确保已安装 uv 和 Spotify 应用。
  2. 将以下配置添加到 claude_desktop_config.json 文件中:
{
  "mcpServers": {
    "music-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "--with",
        "spotipy",
        "/path/to/music-mcp/server.py"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_spotify_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret",
        "SPOTIFY_REDIRECT_URI": "your_spotify_redirect_uri"
      }
    }
  }
}

调试方式

  1. 确保所有依赖已正确安装。
  2. 检查 claude_desktop_config.json 文件中的配置是否正确。
  3. 运行 uv run --with mcp --with spotipy /path/to/music-mcp/server.py 命令,查看是否有错误输出。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。